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Preface 



The TCAM User's Guide is for systems analysts and programmers who must 
design, write, and install a TCAM program. It is both a guide for diagnosis and a 
problem determination handbook. The INTRODUCTION to the TCAM User's 
Guide names and briefly describes the four chapters and their appendixes. 

An acronym list and a list of illustrations which is organized by chapter and by 
appendixes follow the table of contents. 

Before you read this book, you should be familiar with the OS TCAM 
Programmer's Guide and Reference Manual, GC30-2024, and the OS TCAM 
Concepts and Facilities, GC30-2022. You will also find the TCAM PLM, 
GY30-2029, helpful. 

Use this publication in conjunction with the publications shown in the following 
chart. Abbreviated titles refer to other publications throughout this publication. 
The chart below shows both the abbreviated and the full titles. 



Abbreviated Title 

Principles of Operation 

Utilities 

System Control Blocks 

Guide to Reading Dumps 

OS Service Aids 

TCAM Concepts and Facilities 



TCAM Programmer's Guide 



I/O Supervisor PLM 



TCAM PLM 



Full Title Order No. 

IBM System/ 3 60 GA22-6821 

Operating System: 
Principles of Operation 

OS Utilities GC28-6586 

OS System GC28-6628 

Control Blocks 

Guide to Reading GC28-6670 

OS System Dumps 

IBM System/ 3 60 GC28-6719 

Operating System: 
Service Aids 

IBM System/360 GC30-2022 

Operating System: 
Telecommunications Access 
Method (TCAM) Concepts 
and Facilities 

IBM System/360 GC30-2024 

Operating System: 

TCAM Programmer's 

Guide and Reference 

Manual 

IBM System/ 360 GY28-6616 

Operating System: 
Supervisor Logic 

Telecommunications GY3 0-2029 

Access Method (TCAM) 
Program Logic Manual 
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Introduction 



You can use the OS TCAM User's Guide in three ways: 

1. As a source of hints for originally coding your TCAM message control program 
and application programs. 

2. For diagnosing a TCAM problem when you first try to run TCAM. 

3. For problem determination during the initial stages of trouble shooting in a 
system that uses equipment provided by more than one vendor. 

Chapter 1, OVERVIEW, is an enhancement of TCAM Concepts and Facilities. 
After you have become familiar with the TCAM Concepts and Facilities and 
TCAM Programmer's Guide manuals, Chapter 1 will provide a transition to the 
remaining chapters of this guide. 

Chapter 2, TCAM CODING AIDS, discusses pre-assembly aids to help you code 
your TCAM program so that it will be as error-free as possible. The first section 
shows the functions of a TCAM program in proper coding order. The second 
section describes macros that you can include in your program to detect and 
handle errors in messages and in the teleprocessing network. 

Chapter 3, TCAM PROBLEM DETERMINATION AIDS, suggests where you 
can look in your code when you have an error. Each possible problem area is 
discussed. Lists of the more common errors that can be made are given. Use this 
chapter to review your code before you first run a TCAM program. Use it also, 
when you have a problem, to review possible problem areas. In addition to errors 
in your code, Chapter 3 also summarizes other sources of errors, such as hard- 
ware, software, and those that might be caused by system console operators and 
terminal users. 

Chapter 4, TCAM DIAGNOSTIC AIDS, tells you what information TCAM 
provides for your use in diagnosing problems, and how you can get copies of the 
information. The first section, Gathering and Interpreting Data From Dumps, 
covers the TCAM program and all the data sets that you can dump and print. 
This first section also suggests the kinds of errors that you can find, where to look 
for them, and, in some cases, what normal operations look like. The second 
section, Using Operator Commands, summarizes operator commands that you can 
issue to determine and alter the status of your TCAM system while it is running. 
The last section, Normal End-of-Day Closedown, suggests what data you might 
want to copy during your normal end-of-day closedown. 

APPENDIX A includes charts showing TCAM control block linkages. 

APPENDIX B is a summary of TCAM macros and their operands. 

APPENDIX C is a field-by-field description of the output from a formatted 
TCAM dump. 

APPENDIX D includes charts showing device configurations supported by 
TCAM. 

Following is a general overview of TCAM. Read this before coding, to familiarize 
yourself with the facilities provided by TCAM. 
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Overview 



What is TCAM? 



How do you invoke the 
facilities of TCAM? 



Network Definition 



TCAM is: 

• A general purpose TP access method that provides facilities to exchange data 
between a CPU and remote terminals. 

• A control program that optimizes allocating and scheduling a computer's 
resources in a real-time teleprocessing environment. 

Resources optimized: 

1. CPU time 

2. Main storage 

3. I/O paths (lines and channels) 

• A high-level language composed of macro instructions designed specifically to 
facilitate building a TP network control program. 



Code a message control program (MCP) containing sections in which you: 

• define the TP hardware — terminals and lines — to TCAM; 

• define data sets in which TCAM queues incoming messages until they are sent 
to their destinations; 

• construct message handlers to Dtranslate, edit, and verify the validity of the 
input data; 2)route incoming and outgoing messages to their destinations; 3) 
invoke certain system functions such as logging; 

• define an interface to application programs for message processing; 

• specify which of TCAM's service facilities, operator control, 
checkpoint/restart, logging, debugging aids, on-line test you want to be 
included; and 

• include routines to activate and deactivate the TP network. 



At system generation time, be sure your UCBs are correct. Know your network 
configuration and what you have (features). 

Macro instructions involved: 

• Line Group DCB macro: defines a group of lines with similar characteristics 
(for instance, you might define a group of lines for IBM 1050 terminals by a 
line group DCB macro). This macro specifies information applicable to termi- 
nals as a group, such as the translation table to be used to translate incoming 
and outgoing messages for the terminals, the buffer size for buffers servicing 
lines in the group, and the message handler to handle messages to and from 
terminals assigned to lines in this group. You do not have to define your similar 
terminals in a line group. Each terminal may be defined with a unique DCB. 
The decision to place your terminals in a line group rather than having individu- 
al DCBs is based on the planned usage of the terminals (are they output only?) 
and on main-storage conservation. 

• TERMINAL macro: defines an individual remote terminal to TCAM. Gives 
the terminal a name, specifies the type of queuing to use for messages sent to 
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Figure 1. Overall Structure of the Message Control Program 

this terminal, the addressing characters to use in addressing this terminal, this 
terminal's telephone number if it is on a dial line, etc. 

• INVLIST macro: specifies the characters to invite (poll) each terminal on this 
line to enter data (one macro per line). 

Tying it together: 

The TERMINAL macro names the line group DCB macro for the line to which 
this terminal is assigned. The line group DCB macro names the INVLIST macros 
containing the invitation characters for each terminal on a line in the line group. 
The line group DCB macro also names a DD statement that specifies the hardware 
address of each line. 

• Code one line group DCB macro for each group of lines to terminals with 
similar characteristics. 

• Code one TERMINAL macro for each terminal in the network. 

• Code one INVLIST macro for each line on which there are terminals that can 
enter data. 



Starting TCAM 



The TCAM MCP is just another problem program to OS. 

Assembling, link-editing, and executing steps for a TCAM MCP are similar to 

those for any other problem program running under OS. 
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Figure 2. Overview of a TCAM Program 

• A TCAM MCP normally executes as the highest-priority task in the highest- 
priority region or partition in the system (for performance reasons). 

• You can issue any OS macro within the MCP but you must be aware of the 
system implications. That is, you significantly degrade MCP performance if 
you issue an OS WAIT as a result of an OS macro execution. 

• You can start a TCAM MCP in three ways: 

1. Place the appropriate execution JCL in the card reader and use the OS 
Reader/Interpreter to place the job in the system. 

2. Catalog the MCP JCL in SYS1.PROCLIB and start the job from the system 
console with a START command. You can catalog different copies of the MCP 
and use the appropriate copy as your operational requirements vary. 

3. Issue an ATTACH macro from another task. 

Activate TCAM application programs any time after the MCP is activated; 
deactivate them independently of the MCP. If a message arrives in the MCP for 
an application program that is not currently active, TCAM places the message on 
the destination queue for that application program, and it remains there until the 
application program is activated and fetches the message with GET or READ 
macros. 

TCAM application programs 

• can be in a separate region or partition, or 

• can be attached by including OS ATTACH macros after the OPEN macros but 
before the READY macro in the MCP activation and deactivation section; 

• can also be attached with an ATTACH macro in line in the MCP message 
handler. 
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Figure 3. MCP Macro Instructions 

• You must close down or detach TCAM application programs before closing the 
MCP. 

More information on activating and deactivating the MCP and application pro- 
grams and on the relationship between the MCP and application programs is 
contained in the TCAM Programmer's Guide. 

Activating and Deactivating TCAM 

Activate the TCAM program with INTRO, OPEN, and READY macros. 
The INTRO macro 

• performs the bulk of TCAM system initialization; 

• establishes addressability for the MCP; 

• has operands that specify various system-wide parameters dealing with 
buffering, type of start-up, queuing, operator control, checkpoint/restart, 
on-line test (TOTE), and diagnostic aids. 

• Most operands can be specified or changed at execution time at the system 
console. 

The OPEN macro: 

• completes the initialization and activation of the MCP data sets; 

• is required for each MCP data set represented by a DCB macro. 
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Message Flow 



The READY macro: 

• Completes the initialization and activation of the MCP; after READY 
executes, TCAM is ready to handle incoming messages. 

Types of start-up (specified by an operand of INTRO): 

• Cold: Start from scratch; ignore the previous environment. 

• Warm: Use TCAM's checkpoint/restart facility to reconstruct the MCP 
environment as it existed before closedown, and start from that point. 

• Continuation: Similar to warm, but restarts following a system failure rather 
than an orderly closedown, so that TCAM's checkpoint/restart facility is used 
in a somewhat different manner to achieve the same result — a reconstructed 
MCP environment without loss of completely received messages. 

Deactivate with CLOSE macros, and with the MCPCLOSE macro or the SYSC- 
LOSE operator command. 

To close the MCP, deactivate your application programs, then issue an 
MCPCLOSE macro or a SYSCLOSE operator command specifying either a quick 
or a flush close. 

Quick Close: TCAM stops message traffic on each line as soon as the current 
message is completely received or sent. When all traffic ceases, TCAM closes the 
MCP data sets and returns control to OS. 

Flush Close: After the message currently being processed on each line is com- 
pletely received or sent, TCAM sends all messages queued for terminals on that 
line to their destinations and closes the line. When all lines are closed, TCAM 
closes the MCP data sets and returns control to OS. 



TCAM places a message coming into the MCP over a line into buffers that you 
have assigned to that line for input operations. 

The message goes through the incoming group of the message handler for the line, 
and is then queued in a destination queue. If the destination queue is located on 
disk, the buffers are released; if the queue is in main storage, the buffers contain 
the message in the main-storage queue that you defined with the operand of the 
INTRO macro (MSUNITS = ) . 

If the destination is an application program, TCAM reads the message from the 
disk or the main-storage queue into buffers, and sends it through the outgoing 
group of the message handler for the application program. It is then placed on a 
special main-storage read-ahead queue until it is moved into the application- 
program work area with a GET or READ macro. 

Messages transferred from the application-program work area to the MCP with 
PUT or WRITE macros are put into buffers and sent through the incoming group 
of the message handler for the application program, after which they are placed on 
a destination queue on disk or in main storage. 

If the destination of the message is a terminal, TCAM reads the message from the 
destination queue on disk or in main storage into buffers, and sends it through the 
outgoing group of the message handler for the line. It is then sent to the destina- 
tion terminal. Once the message has been transmitted, the units making up the 
buffers that contained it are available for reallocation. 
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Figure 6. TCAM Message Flow 



Buffering Scheme 



Various size buffers are constructed from fixed-sized units that are taken from a 
unit pool, whose size you define: 

• Each unit has a 12-byte prefix containing control information. 

• In addition, each buffer has a prefix in which TCAM keeps message-related 
control information. 
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Queuing Scheme 



• The buffer holding the first piece of a message has a 30-byte prefix. 

• Buffers holding subsequent pieces of the message have 23-byte prefixes. 
You specify the size and number of buffers to handle I/O over the lines in a line 
group in the line group DCB macro. You specify the size and number of buffers 
to handle I/O between the TCAM message control program and an application 
program in the PCB macro. 

Before starting an I/O operation for a line, TCAM constructs a user-specified 
number of buffers from units in the unit pool, and assigns them to the line. If 
enough units are not currently available to construct the required number of 
buffers, TCAM defers the I/O operation until units are available. The line group 
DCB macro allows you two options for allocating buffers: 

1 . You can specify that a relatively small number of buffers be allocated initially 
to handle an I/O operation, and that more buffers are to be allocated with PCI 
interrupts as they are needed (PCI=A,A). 

2. You can specify that a fixed number of buffers, sufficient to hold the entire 
message being sent or received, is to be available before I/O begins 
(PCI=N,N). 

Dynamic allocation (using PCI) improves performance by breaking work into 
small pieces over a period of time. With dynamic allocation (option #1), fewer 
buffers are tied up at any one time in an I/O operation than with static buffering 
(option #2), but CPU utilization is higher, and incoming data can be lost since 
TCAM may not be able to replace buffers as fast as they are filled (perhaps 
because traffic is heavy and no units are currently available to form buffers). You 
can minimize this possibility by assigning more buffers to your line, by making 
your buffers larger, or by increasing the number of units in your unit pool. All of 
these actions can be taken at INTRO execution time. 



In TCAM, messages entered by remote terminals or application programs are 
queued by destination. 

Queuing by destination permits overlapping line usage in I/O operations; mes- 
sages with a common destination may be received simultaneously from more than 
one source, even while the destination itself is busy sending or receiving a mes- 
sage. Queuing smooths out peaks and valleys in message traffic. Disk queuing 
permits a high volume of concurrent terminal operations to proceed without 
requiring excessive main storage for buffering. 

You can locate destination queues either in main storage or on disk. You specify 
in your TERMINAL or TPROCESS macro (QUEUES=operand) whether you 
want disk or main-storage queuing for the terminal or application program. 

A destination queue may be located 

• in main storage 

• on disk 

• in main storage with disk backup. 

Main-storage queuing gives the best performance, but 

• it may require excessive main storage; 

• it compromises recovery capability. 

• it may cause a reliability problem and can lose messages if memory allocated by 
the MSUNITS= operand on INTRO fills up. 
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Disk queuing is slower than main-storage queuing and requires disk and channel 
resources, but you can checkpoint and restart the system after failure without 
losing data if you use disk queuing. 

Disk backup for main-storage queuing is a compromise; it is faster than disk 
queuing but slower than main-storage-only. You can checkpoint and restart the 
system after failure without losing data when you use disk backup. Also, with disk 
backup, if the units specified by MSUNITS= are all used, you do not lose mes- 
sages as you would with MS-only queuing. 

• If you use disk queuing, you may elect to define reusable or non-reusable disk 
data sets. 

• With reusable queuing, TCAM wraps around when it gets to the end of the 
unused space in the data set and reuses that part of the data set containing 
messages that have already been sent to their destinations. A revolving zone 
technique is employed internally. 

• With nonreusable queuing, when TCAM gets to the end of unused space in the 
data set, it suspends invitation, sends out all queued messages, and closes itself 
down. 

• Reusable disk permits perpetual operation, and makes the best use of disk 
space, but it costs CPU time and channel usage because the disk must be 
periodically reorganized. 

• You can optimize disk performance by defining a data set on several volumes, 
assigning each volume to a different channel; TCAM optimizes I/O for 
multiple-arm support. 



Message Handlers 



Message handlers are sets of routines you code with TCAM macros and user code 
to process messages as they enter and leave the TCAM message control program. 
Message handlers examine and process control information in incoming and 
outgoing messages, and prepare these messages for forwarding to their destina- 
tions. 



Structure 



A message handler can have two groups: 

1. an incoming group to handle messages coming into the TCAM MCP from 
stations or application programs; 

2. an outgoing group to handle messages being sent from the MCP to a terminal 
or application program. 

These groups have subgroups: 

• the inheader and outheader subgroups, which handle only headers of incoming 
or outgoing messages (a message header contains control information for the 
message, such as the name of its destination, an input sequence number, its 
origin, etc.); 

• the inbuffer and outbuffer subgroups, which handle all incoming and outgoing 
message segments; 

• the inmessage and outmessage subgroups, which specify what is to be done 
after the entire message is received or sent (for instance, check for specified 
errors and send an error message to the source or destination). 
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You include message handler functions by coding macros; among these functions 
are: 

• message editing 

• validity checking 

• message routing 

• record keeping 

• error handling 

• system control 

You can vary the path of a message through an incoming or outgoing group 
dynamically, based on the source or destination of the message, or on the presence 
or absence of certain character strings in the message header. 

To supplement TCAM functions, you can code open or closed subroutines using 
assembler and OS macro instructions and include these subroutines in your 
message handlers. 

Application Program Support 

TCAM permits you to code one or more application programs and to interface 
them with the MCP. Application programmers are insulated from the TP environ- 
ment; they issue OS GETs, PUTs, READs, and WRITEs to move data between 
the MCP and their application-program work areas. 

TCAM application programs are SAM-compatible. You can debug them in a 
non-TP environment using BSAM or QSAM as the access method, and a tape, 
card reader, disk, card punch, printer, etc. as I/O devices. Once you have debug- 
ged them, you can run application programs with TCAM without reassembly by 
changing the DD statement. You can specify that either messages (OPTCD=U on 
the application program DCB macro) or user-defined records be transferred when 
you issue your GET/READs or PUT/WRITEs. 



Interface Definition 



In the MCP, you code two macros to define the application-program interface: 

1 . The PCB macro specifies the message handler for the application program, the 
size of the buffers to transfer data between the MCP and the application 
program, and the number of buffers to be assigned at one time to handle data 
transfer. 

2. The TPROCESS macro establishes a destination queue for the application 
program, serves as part of the PUT/WRITE interface, and specifies the PCB 
for the application program. 

In the application program, input and output DCB macros define incoming and 
outgoing data sets for the application program. These macros are extensions of 
OS DCB macros, and share many of the same parameters. Activate and deacti- 
vate these data sets with OPEN and CLOSE macros. The DCB macros specify 
the format and characteristics of the work units for the application program. 

To transfer data between the application program and the MCP, issue a 
GET/READ or a WRITE/PUT. In the macro, name the input or output DCB 
macro. The DD statement named by the DCB specifies a TPROCESS macro in 
the MCP. The TPROCESS macro specifies a PCB macro that names the 
application-program message handler. 

You can run the MCP independently of any application programs, collecting data 
for later processing or sending data previously written by the application program 
to its destination without having the application program resident. You can save a 
great deal of main storage when you operate in this mode. 
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You can also coordinate checkpoint and restart in the MCP and the application 
program. 



Name 


Operation 


Operand 



GET (or READ) 

or 
PUT (or WRITE) 



mhname 



deb name 



debname DCB DDNAME = ddname 



ddname DD QNAME = procname 



procname TPROCESS PCB = pebname 



pebname PCB 



MH = mhname 



STARTMH 

MH for application 

program 



application 
program 



J 



) MCP 



Figure 7. Interface Between the Application Program and the MCP 
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FUNCTIONAL GROUP 


MACROS 


Data Set 
Definition 
and Control 


DCB 

OPEN 

CLOSE 

GET 

PUT 

READ 

WRITE 

CHECK 


Network 
Control 


ICHNG 

ICOPY 

MCPCLOSE 

MRELEASE 

POINT 

QCOPY 

TCHNG 

TCOPY 


Checkpoint 
Control 


Q START 
CKREQ 



Figure 8. Application Program Macro Instructions 



Service Facilities 
Operator Control 



A set of commands allows you to determine the status of your TP system and 
alter, activate, or deactivate portions of that system by entering appropriate 
commands from the system console or a remote terminal. 



Checkpoint /Restart 



Logging 



This facility allows the TCAM system to be restarted with minimum loss of 
message data following closedown or system failure, by periodically recording, in a 
special data set on disk, information on the status of each station, destination 
queue, terminal-table entry, and invitation list in the system. TCAM uses this 
information to restore the MCP environment to its condition before closedown or 
failure. 

You can include code in your MCP to selectively copy incoming or outgoing 
messages or message segments on a tape or disk. This facility records message 
traffic through the MCP. 



Diagnostic Aids (COMWRITE) 

You can dump diagnostic information onto tape or disk. This information in- 
cludes the subtask control block (STCB) trace, the line I/O interrupt trace and 
the buffer trace. 
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I/O Error Recording 



You can use the extensive TCAM error-recording facilities (including OBR/SDR) 
if you have terminal-related I/O errors. 



On-Line Test (TOTE) 

Using the optional TCAM on-line test facility, you can test transmission control 
units and remote terminals without closing down the MCP. Use this function to: 

• diagnose hardware errors; 

• verify repairs; 

• verify engineering changes; 

• check devices periodically; 

• check new stations brought on-line. 

Other Internal Design Highlights 

• Request-driven priority dispatching of TCAM subtasks. 

. Use of ATTACH for operator control, checkpoint, TOTE and COMWRITE. 

• Channel programs based on device characteristics rather than on device type. 

• Multiple routing without complete multiple copies of messages. 

• Disk queuing use of key and data fields to avoid extra disk activity. 

• Channel program restart to initiate a new channel program for disk queuing. 

• Line scheduling to provide send, equal, or receive priorities with unique 
handling for buffered terminals and switched connections. 
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TCAM Coding Aids 



This chapter discusses preassembly aids to help you code your TCAM program so 
that it will be as error-free as possible. The first section shows the functions of a 
TCAM program in proper coding order. The second section describes macros that 
you can include in your program to detect and handle errors in messages and in 
the teleprocessing network. 



Function Checklists 



Seven checklists, in flowchart format, show the TCAM macros, their functions, 
and their proper coding order. Included are: 

• how to arrange the message control program (MCP), 

• how to define your buffer requirements, 

• how to define message queues data sets, 

• how to code checkpoint/restart needs, 

• how to determine operator control requirements, 

• how to include the TCAM diagnostic aids in your MCP, and 

• how to arrange a TCAM application program. 

Use these charts as you code; also use them to review your coded TCAM system 
before you assemble it. 

MCP Arrangement Checklist 

Figure 9 shows how to code a message control program. It includes all macros 
except the functional message handler (MH) macros. The five major sections of 
an MCP are shown in logical order. You must code the initialization, activation, 
and deactivation sections in the order shown. If you follow the order of the other 
sections as shown in the chart, your assembly listing will correspond to the order 
of related control blocks and routines in main storage. You will then find it easier 
to diagnose from a dump and your assembly listing. 

Buffer Definition Checklist 

Figure 10 shows all macros and operands that you must code to define the buffers 
you will use in your TCAM system. 
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Figure 9. MCP Arrangement Checklist 
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a decimal value 
between 35 and 255. 
It must be large enough 
to accommodate the 

rger of a header prefix 
+ reserve bytes or a text 
prefix + reserve bytes. 
To conserve storage, valu 
+12 should be 
divisible by 8. 




/-A4 

/ Determ 

/ which 

-►\ specified 

\ value is 

\ large 




maximum number of 
"" buffers allocated to 
a line at one time 



if you omit, the larger 
of the values specified 
for BUFINand 
BUFOUT is used 



program-controlled 
interrupts are used to 
control dynamic 
buffer allocation and 
deallocation 



determine the type 
required from the 
TCAM Programmer's 
Guide 



if you are, you 

must reserve space 

in the buffer for the 
insertion 



Number of buffers 
initially assigned for 
receiving operations 
for each line in the 
group 



Number of buffers 
initially assigned for 
sending operations 
for each line in the 
group 




Code second 
suboperand of 
RESERVE = 
ine group 
DCB macro 



Figure 10. Buffer Definition Checklist 
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TCAM Unit Pool Analysis 

The following forms may prove useful in specifying buffer unit and buffer size, 
and buffer pool requirements. They may also be useful in deciding preliminary 
requirements. Final requirements are application dependent and must be deter- 
mined through operating experience. 
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TCAM UNIT POOL ANALYSIS 



LINE TYPE 



Maximum Output Message =_ 
Maximum Input Message =_ 



Bytes 
Bytes 



Dynamic Buffering Required YES/NO 

SELECTED BUFFER SIZE: 
Reason for Selected Buffer Size: 



PCI = 

BUFSIZE = 



Bytes 



BUFFER REQUIREMENTS FOR 1 MESSAGE 

Output Buffers = : Input Buffers = 



If Dynamic Buffering, 

NUMBER OF LINE UNITS REQUIRED 

( BUFSIZE/UNITSIZE )*BUFMAX 

If Main-Storage Queuing: 

NUMBER OF MAIN-STORAGE UNITS REQUIRED 

Reason: 



SELECTED BUFOUT = 
SELECTED BUFIN = 
SELECTED BUFMAX = 



LNUNITS 



MSUNITS 



If Disk Queuing: 

CALCULATE NUMBER OF CPBs REQUIRED 

NUMBER OF CHARACTERS TO AND FROM DISK/sec 

NUMBER OF UNITS TO AND FROM DISK/sec 
( characters/sec/unitsize ) 



ALLOW 1 CPB/UNIT/sec 



SUMMARY 

UNIT REQUIREMENTS 

LINE/APPLICATION PROGRAM 



NUMBER OF CPBs REQUIRED 



Bytes 



Units 



CPBs 



LNUNITS MSUNITS CPB UNITS 
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TOTALS 

TOTAL UNITS = 



CORE REQUIREMENTS 

UNIT SPACE (UNITSIZE + 12 + wasted bytes) * TOTAL UNITS 

= Bytes 

CPB SPACE = Number of CPBs * ( 72 + unitsize)-. = Bytes 

TOTAL MAIN STORAGE REQUIREMENT = 
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Message Queues Checklist 

Figure 1 1 shows all macros and operands that you must code to use each of the 
five TCAM queuing types. 

Checkpoint / Restart Checklist 

Figure 12 shows all macros and operands that you must code to checkpoint and 
restart your TCAM system. It also shows the macros and operands that you must 
code in an application program when you want to coordinate TCAM checkpoints 
of the MCP with OS checkpoints of the application program. 

Operator Control Checklist 

Figure 13 shows all macros and operands that you must code if you want to use 
operator control from either the system console, remote terminals, or application 
program. 

Diagnostic Aids Checklist 

Figure 14 shows all the TCAM diagnostic aids, except operator control and 
checkpoint/restart, and all the macros and operands you must code to include 
each diagnostic aid in your MCP. 

Application Program Checklist 

Figure 15 shows how to code an application program to run with a TCAM MCP. 
All necessary macros, work areas, and special coding are shown. 

Coding Hints to Alleviate Errors 

This section discusses the TCAM macros that handle errors that occur while your 
TCAM system is running. Using these macros, you can test for and recover from 
both errors in messages and errors in hardware. You can also define logical errors 
for your system, and use TCAM macros to test for and recover from these errors. 
TCAM indicates errors in a message error record, which is defined for each 
message as it is being processed. 

The Message Error Record 

TCAM assigns a five-byte message error record to each message while it is being 
processed by the incoming or outgoing group of a message handler. Each of the 
40 bits of the message error record, except reserved bits, indicates the presence 
(when 1) or the absence (when 0) of a specific error that has affected or may 
affect successful processing or transmission of the message. 

Errors recorded in the message error record include transmission and equipment 
errors (lost data, bus-out check, etc.), mistakes in entering a message (wrong 
sequence number, invalid origin, etc.), and shortages of system resources 
(insufficient number of buffers, insufficient space in a main-storage-only message 
queues data set, etc.). The last byte of the message error record is the sense byte 
for the transmission control unit being used. 
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©main 
-* 



-storage 




maximum number 
of main-storage 
buffer units that 
may be used for 
queuing 

Bits are set in the 
message error record 
when the queue is 
nearly full or nearly 
empty. You must 
issue a MSGGEN 
or ERRORMSG 
macro with these 
bit settings to 
obtain a warning 

if you omit, defaults 
assigned are 50 and 70 
May also be omitted 
here and specified at 
execution time if you 
are going to get the 
IED002A msg 



DISK = YES says that 
disk queues are used. 
CPB = specifies the 
number of channel 
program blocks used to 
transfer data to disk 




specifies how full the 
disk data set is to 
become before a flush 
closedown of the 
system is initiated 



Figure 1 1. Message Queues Checklist 
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(H> 



/ Determine 

/ how many 

\ destination 

\ queues 



Code 
CKREQS = 
INTRO 
macro 



(•A3 — 
Determine 
environment 
record to 
restart 
with 



maximum number of 
seconds. A decimal 
value between 30 
and 65535 



Code 

RESTART = 
INTRO 



Code a 

checkpoint 

DCB 

macro 



Determine \ 


between 2 and 75 


how many \ 


records may be 


environment /"" ~ 


— — — maintained on the 


records to / 


checkpoint data 


keep / 


set on disk 



Prepare a 
DD statement 
for the DCB 




types are cold, warm, 
and continuation. See 
TCAM Programmer's 
Guide for details 



if you do not choose 
to code it here, you 
may specify the value 
at execution time 



its? 



Yes 



Code 
EXLST = 
checkpoint 
DCB macro 



rG3- 



Code an 
OPEN for 
the DCB 



H3 



Hav 



option fields 



destination queues in 
use at any one time 
for application 
programs that use the 
CKREQ macro 
instruction 



J3 



them 



. checkpointed 



Code a 
CHECKPT 
macro in 
theMH 



is the latest, 1 is 
the next-to-latest, 
etc. Maximum value 
is 255 but must be less 
than the value specified 
in CPRCDS 



exits include user- 
label, data control 
block, and user- 
ABEND 




data set must be 
opened INOUT 



Code 

CKPTSYN = YES 
on TPROCESS 
macro 



Code 
EXLST = 
application 
program DCB 



C ~") 



can be included in 
any subgroup 



Figure 12. Checkpoint/Restart Checklist 
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number of commands 
that can be entered 
at any one time 
from the console 



If not specified, 
the system console 
is automatically 
assigned 



must be an entry 
in the terminal 
table defined as 
a secondary station 
that can both enter 
and accept msgs 



(-H3 
Decide 
which 
stations 
to be 
secondary 



secondary stations 
must be capable 
of both entering and 
accepting msgs 



■J3" 



Code 

SECTERM = YES 
TERMINAL 
macros 



C™ ) 



Figure 13. Operator Control Checklist 
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c 



rci- 



Code 
OLTEST = 
INTRO 
macro 



Code 

CROSSRF = 
INTRO 
macro 



,F1 



Want 



dispatcher 



rGI- 



Code 
DTRACE = 
INTRO 



I/O 



Code 
TRACE = 
INTRO 
macro 



Initialize 
for operator 
control 



Specifies number 
_ of 1 K bytes of 
storage allocated 
to TOTE 




should have as 
many as lines that 
will be opened 



rD3 



Code 

COMWRTE = YES 
INTRO 
macro 



tracing is started 
and stopped using 
control commands 




Figure 14. Diagnostic Aids Checklist 
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/ Prepar 

/ READ, 

( WRITE and 

\ CHECK 

\ macros 




Figure 15. Application Program Checklist 
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The message error record indicates most user and hardware errors. You can 
minimize your problem determination time if you use this record and issue error 
messages for every error condition. Such use warns of impending trouble on the 
line or in the system. It can be used to indicate internal bugs and hardware 
conditions causing degradation. You may want to have an application program to 
collect data and give end-of-day tallies of errors to the system control program- 
mer. 

Figure 16 is a quick reference table of the message error record. See the TCAM 
Programmer's Guide for more information about the bit meanings. 



Using the Message Error Record to Detect Message Errors 

Several TCAM macros can help you find errors in messages. Each of the follow- 
ing macros sets a bit in the message error record for the message when an error in 



BYTE 


BIT 


KEYWORD 


VALUE 


DESCRIPTION 


First 



1 
2 
3 


Scan 
Origin 

Seq High 


X ' 80' 
X ' 40 ' 

X ' 10' 


Scan Pointer Has Passed Message End 

Invalid Origin Code 

(Reserved) 

Sequence Number High or Not A Valid Decimal Number 


4 
5 
6 

7 


Seq Low 

Buffers 
Cutoff 


X ' 08' 

X ' 02 ' 
X ' 01 ' 


Sequence Number Low 

(Reserved) 

Insufficient Buffers For Message 

Message Exceeds Cutoff Limit or RVI Error 


Second 


8 
9 
10 
11 


MSMIN 
MSMAX 


X ' 80' 
X ' 40' 


Main-Storage Queue is Below MSMIN 
Main-Storage Queue Exceeds MSMAX 
(Reserved) 
(Reserved) 


12 

13 
14 
15 


Tote 

BSC Abort 
Dest 


X ' 08' 
X ' 04' 
X ' 02 ' 


TOTE is Not In System 

Abnormal Termination During Input/Output 

One or More Forward Destinations Invalid 

(Reserved) 


Third 


16 
17 
18 
19 


_MS Full 

Bad Ident 
Dest Held 


X ' 80' 
X ' 40' 
X ' 20' 


Last Part of MSG Lost As Main-Storage Queue Full 
Invalid Station ID From Terminal 
Destination Station Held (Intercepted) 
(Reserved) 


20 
21 
22 
23 


User Bit 
BSC Format 

Unit Excep 


X ' 08' 
X ' 04' 

X ' 01 ' 


As Required By User 

Invalid BSC Format (No Starting STX) 

(Reserved) 

Unit Exception Set By Transmission Control Unit 


Fourth 


24 
25 
26 
27 


Selection 
Text 

Switching 
Station 


X ' 80' 
X ' 40' 
X ' 20' 
X ' 10' 


Error During Polling Or Addressing 

Text Error During Transfer of Data 

Switching Error During Connection or Disconnection 

Station Faulty 


28 
29 
30 
31 


Control 
Channel 
Unknown 


X ' 04 ' 
X ' 02 ' 
X ' 01 ' 


(Reserved) 

Control Unit Faulty 

Channel Faulty 

Unknown Error (TCAM Cannot Determine Cause of Error) 


Fifth 
(Sense) 


32 
33 
34 
35 


Command 
Help 
Busout 
Equipment 


X ' 80' 
X ' 40' 
X '20' 
X ' 1 ' 


Invalid Command or Sequence 
Operator Intervention Required 
Parity Error Between TCU and Channel 
Transmission Control Unit Has Failed 


36 
37 
38 
39 


Data Check 
Overrun 
Lost Data 
Timeout 


X ' 08' 
X ' 04' 
X ' 02 ' 
X ' 01 ' 


Parity Error Bad Binary Chk Count on Received Data 
Received Data Lost (MPX Channel Service Not In Time) 
MSG Too Long For Read Cmd or Data Read While No Read 
Time Limit Termination of Any Receiving Command 



Figure 16. TCAM Message Error Record Summary 
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SEQUENCE Macro 



the header is found. This validity checking improves the reliability of transmitted 
traffic. To use the macros most effectively, you should cancel any invalid input 
messages to be sure that only valid messages are transmitted. You should also 
issue an error message to the terminal operator who enters an invalid input 
message, so that he knows the message was not processed. 



When you code it in the inheader subgroup, the SEQUENCE macro verifies the 
input sequence number in the header by comparing it to an internal counter in the 
terminal entry. TCAM increments this input counter for each message that has a 
correct sequence number in the header. If the sequence number is not one greater 
than the sequence number of the last message received from the same station or 
application program, TCAM sets an error flag in bit 3 or bit 4 of the message 
error record for the message. The SEQUENCE macro sets bit 3 to 1 (on) in the 
message error record when the sequence number in the header is not a valid 
decimal integer or when it is higher than the expected number for the next mes- 
sage from the station. The SEQUENCE macro also sets bit 4 to 1 (on) when the 
sequence number is low. 

TCAM also places one of the following return codes in register 15: 

X'OO' good return 

X'04' sequence number in the message is high 

X'08' sequence number in the message is low 

X'OC originating station is unknown 

The message is processed normally, regardless of the sequence number, unless you 
cancel it. 

When you code it in the outheader subgroup, the SEQUENCE macro inserts an 
output sequence number in the header of each outgoing message handled by the 
message handler (MH). The output sequence number is inserted when the 
message is actually sent to the destination. You must reserve five bytes in your 
message for the sequence number in the RESERVE= operand of the line group 
DCB macro or the application-program PCB macro. TCAM maintains an output 
sequence number counter in the terminal entry, and does not increment it until the 
message is actually sent to the destination. TCAM does not verify the output 
sequence number. 

Although use of the SEQUENCE macro is optional, you should code it in both 
your inheader and outheader subgroups to check for lost messages and for book- 
keeping. In the inheader subgroup, executing the SEQUENCE macro can warn 
you that the terminal has sent more than one message with the same sequence 
number or that numbers have been skipped. For outgoing messages, executing the 
SEQUENCE macro allows you to account for the messages received by a station. 
Both input and output sequence numbers should be sequential. If sequential order 
is not maintained in the input messages (that is, if a sequence number repeats), 
you know that a message was lost before it reached the MH. If sequential order is 
not maintained for outgoing messages, the terminal operator knows that a message 
was lost after the MH handled it. In either case, you can tell that your problem is 
caused by either trouble on the line or trouble in the station. 

You should be aware, however, that sequential order in the sequence numbers 
does not guarantee that a message has not been lost. The incoming MH may 
handle a message and thereby update the input counter for the originating station, 
but may not forward the message correctly to the outgoing message handler. 
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ORIGIN Macro 



Since the outgoing MH does not handle the message at all, TCAM does not 
update the output sequence number counter, and you have no indication that the 
message is lost. 

Using the SEQUENCE macro, you can account for message traffic on the basis of 
numbers, rather than data. By examining the header it is much easier to verify 
that remote terminal B received input messages with sequence numbers 1, 4, 5, 
and 20 from terminal A than to compare the actual messages sent, especially when 
similar or identical messages are sent more than once to a station. 

You should use the SEQUENCE macro for accounting and problem determina- 
tion. You should use it to put sequence numbers in outgoing messages that you 
want to retrieve in an application program via the POINT macro (refer to the 
TCAM Programmer's Guide). The count is internally maintained and the se- 
quence number in the outgoing subgroup lets you know which output message you 
can retrieve. 



For nonswitched stations, the ORIGIN macro verifies that the origin field in the 
header contains the symbolic name of the station invited to send the message, by 
comparing the origin field with the name of the terminal-table entry for the station 
that was contacted. For switched stations, the ORIGIN macro both verifies the 
origin field in the header and identifies the calling station to TCAM. Unless the 
calling station is a BSC station that transmits a unique ID sequence when it 
successfully contacts the computer, TCAM does not know which station is on the 
line until you issue an ORIGIN macro in the inheader subgroup of the MH. If the 
origin field in the header does not match the name of a terminal entry, TCAM sets 
bit 1 on in the message error record for the message. TCAM also places one of 
the following return codes in register 15: 

X'00' good return 
X'04' invalid origin 

Although use of the ORIGIN macro is optional except in message handlers for 
switched start-stop stations, you should code it in all your message handlers to 
improve the security of your system. You and you alone know the names assigned 
to your stations by the TERMINAL macros in the MCP. These names are the 
only valid sources for messages coming into your system. The ORIGIN macro 
simply verifies the source. You should cancel messages with invalid origins to be 
sure that messages from an "unknown" user are not transmitted. 

An origin field in the header of your message readily identifies the station that 
entered the message. You should execute the ORIGIN macro and cancel any 
message with an invalid origin field in the header to eliminate any confusion that 
may develop at the receiving station about the source of the message. Canceling 
the message with an invalid origin is most important during inquiry processing, if 
you code OPTCD=W in the application program input DCB macro. TCAM 
automatically places the name of the originating terminal in the first eight bytes of 
the buffer. If the name is invalid, when an incoming subgroup for the application 
program handles the message with FORWARD DEST=PUT, it sends the message 
to the dead-letter queue, if provided, or loses it. 

Also, it is easier to determine the source of each message in your end-of-day 
accounting of message traffic. Using the origin field, you can also calculate how 
much each terminal uses the system. 
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FORWARD Macro 



TERRSET Macro 



When the FORWARD macro executes in the inheader subgroup, TCAM scans the 
destination field in the header of each incoming message and compares this field 
with the names of the terminal entries. If the destination code is valid (that is, if 
TCAM finds a matching entry in the terminal name table), the FORWARD macro 
queues the message for the specified destination. If the specified destination is 
invalid, TCAM sets bit 14 on in the message error record for the message. TCAM 
also places one of the following return codes in register 15: 

X'OO' good return 
X'04' invalid destination 

Besides checking the error bit or the return code, you can take three possible 
actions for an invalid message: 

1. If you specify an exit routine in the EXIT= operand of the FORWARD macro, 
control passes to this routine. In the routine, you can correct the invalid 
destination, specify another destination, or indicate that the message is not to 
be processed. See the TCAM Programmer's Guide to learn how to code this 
exit. 

2. If you do not specify an exit, or if you supply an invalid destination in the exit, 
TCAM queues the message for the station or application program that you 
specified as the dead-letter queue in the DLQ= operand of the INTRO macro. 

3. If you specify neither an exit nor a dead-letter queue, the message is overlaid 
and lost. 

You do not have to cancel a message with an invalid destination. Omitting both 
an exit routine and a dead-letter queue causes the incorrect message to be overlaid 
and lost. If, however, you wish to retain a copy of the messages directed to an 
invalid destination, use a dead-letter queue rather than an exit routine for two 
reasons. First, there are times you will write your own code and you might 
unknowingly supply erroneous information to TCAM when you return from the 
exit routine, and cause a program check in a TCAM module. The problem can 
seem to be in TCAM when, in reality, the information you supplied in your exit 
caused the trouble. Second, if you omit the EOA delimiter, at most two copies of 
the message are sent to the dead-letter queue; whereas, if you supply a valid 
destination in your exit routine, that destination will receive up to 255 copies of 
the message. When there is no EOA delimiter in the message, the FORWARD 
macro compares each maximum number of bytes in a terminal name (the value 
specified in the MAXLEN= operand of the TTABLE macro), and any number of 
bytes less than the maximum delimited by blanks, with the entry names in the 
terminal name table. Figure 17 illustrates the consequences experienced when a 
user-exit routine sent messages with an invalid destination to one specified 
terminal. The MAXLEN= value on the TTABLE macro was 8, and the EOA 
delimiter, a /, was missing. You can see from the example that using the dead- 
letter queue saves you computer processing time, line time, and terminal usage 
time. 



The TERRSET macro sets bit 20 on in the message error record for a message. 
Executing this macro is left entirely up to you. You define the conditions under 
which the bit is set. Usually, you would code it to flag as an error a message that 
is logically "wrong" for your message handler. 



32 OS TCAM User's Guide 



VALID 12 3 4 5 6 7 

1 X NYC 1 09.149. 11 NYC THIS IS A BUNCH OF SYMBOLS,!, , | | | . 

2 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, ,, | | | . 

3 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS,,, III. 

4 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, , , I I I . 

5 X NYC 1 09.U9.11 NYC THIS IS A BUNCH OF SYMBOLS,,, III. 

6 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, ,, | | | . 

7 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, ,, | | | . 

8 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS,,, | | I . 

9 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, ,, I I I . 

10 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS, ,, 1 I I . 

11 X NYC 1 09.1*9.11 NYC THIS IS A BUNCH OF SYMBOLS,,, III. 

Figure 17. An Invalid Message with No Dead-Letter Queue 
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Using the Message Error Record to Detect Hardware Errors 



STARTMH Macro 



Two message handler macros notify you of hardware errors by setting bits in the 
message error record. The first, STARTMH, is a delimiter macro that you must 
code. The second, CUTOFF, is an optional functional macro. 



Use the STARTMH macro, which you must code as the first macro in every MH, 
to determine transmission errors or errors that are logical errors for your system. 
If you specify either the STOP=, CONT=, CONV=, or LOGICAL= operand, 
end-of-block (EOB) checking is done. This checking determines, whenever an 
EOB, ETB, ETX, or EOT line control character is received, whether transmission 
or logical errors occurred. Through the STARTMH operands, you control what 
happens to messages in error. 

For an incoming message, EOB checking is done before the message handler 
processes a buffer with an EOB. Terminals with or without error checking may be 
processed by the same MH even though EOB checking is done due to specifica- 
tion of one of the STARTMH operands. With multiple buffer blocks, preceding 
buffers could have been processed when an EOB error is detected in the message. 
If a hardware error is detected and retry is possible, the operation is retried. Retry 
is an error-recovery procedure in which the current block of data, from the last 
EOB or ETB, is re-sent a prescribed number of times (two retries for start-stop 
terminals and six retries for BSC terminals) or until it is accepted or entered 
correctly. If the retry count is exhausted, STARTMH either ignores the error and 
restarts the channel program to receive the next block (CONT= operand), or 
terminates transmission and sends the buffer through the MH as the last buffer of 
the message (STOP= operand). STARTMH branches to the user exit specified 
on the LOGICAL= operand on every EOB, so you can detect errors in the buffer 
containing the EOB. Use this exit to determine whether to stop or continue on 
the basis of the terminals or option fields. 

For outgoing messages, EOB checking is done after each block is transmitted. 
You cannot check for logical errors on output messages. Transmission is success- 
ful when the receiving terminal acknowledges that it successfully received the 
block. Transmission errors detected by the terminal are retried. Once the retry 
count is exhausted, transmission of the message either terminates (STOP=) or 
continues (CONT=) with the next block. 

If the STARTMH macro detects an error in the message, it sets bit 25 on in the 
message error record for the message. You should issue an error message (using 
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ERRORMSG or MSGGEN) to inform the terminal operator that the message was 
in error. He can determine the problem, since he knows if he entered an EOB or 
EOT at the end of his message. If he did, either the station or the line malfunc- 
tioned. 



CUTOFF Macro 



Use the CUTOFF macro to determine hardware errors. CUTOFF sets bit 7 on in 
the message error record for the message if a buffer is filled with identical charac- 
ters or if an incoming message reaches the maximum allowable length. If the 
maximum is reached, TCAM stops receiving as soon as those buffers already 
assigned to the line are filled. The CUTOFF macro does not provide you with a 
precise limit on message size. If dynamic PCI is being employed, the timing may 
be such internally that the PCI requirement for more buffers is honored before the 
CUTOFF macro executes. After the CUTOFF macro executes, TCAM finishes 
filling up the buffers currently assigned to the station. If the operator at the 
station enters a very long message slowly, a request for more buffers may be 
honored before the CUTOFF macro executes, and the long message may be 
received. If, however, the operator enters his message quickly, he may have only 
the original allocation of buffers (no PCI before CUTOFF executes). You can 
sometimes receive a message much longer than one that supposedly was terminat- 
ed after the predetermined length specified on the CUTOFF macro. 

A good use for the CUTOFF macro is to issue it when message switching to a 
buffered terminal. In this way, you can inform the operator at the transmitting 
station that his message is longer than the hardware buffer length at the receiving 
station, and the receiving station did not get all of the message. 

You should send an error message (using ERRORMSG or MSGGEN) to the 
operator who entered the message to notify him that the CUTOFF macro was 
executed, and that the rest of the message will not be received. He will be able to 
determine the problem, since he knows whether he entered a message that was too 
long. If the message length is below the maximum, then the station has malfunc- 
tioned. 

Macros Dependent on the Message Error Record 

The execution of several TCAM functional macros depends on the contents of the 
message error record. Each of these macros has a mask operand, which is com- 
pared to the message error record. The macro executes if any or all of the bits on 
in the mask operand are also on in the message error record. You can thus define 
what is to be done when the stated error occurs. You can unconditionally execute 
each of the following macros either by specifying a mask of all zeros or by omit- 
ting the mask. 



HOLD Macro 



The HOLD macro temporarily suspends outgoing message transmission to a 
station. You can suspend transmission either for a specified time interval or until 
you choose to resume traffic by issuing the RESMXMIT operator command or the 
MRELEASE application program macro. 

Use HOLD to intercept a station; that is, to stop sending messages that should not 
be sent immediately because the destination station is failing or has failed. You 
cannot hold a station (via HOLD) that has main-storage queuing with no disk 
backup. You define the failures in the mask operand of the macro. If any or all of 
the bits in the mask are on in the message error record for the message, TCAM 
sends nothing to the station following that message. If you omit the HOLD 
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CANCELMG Macro 



REDIRECT Macro 



ERRORMSG Macro 



macro, messages that cannot be transmitted because the station is out of order are 
treated as if they were transmitted; that is, the buffer units containing the mes- 
sages are freed and become available for reuse, and the message is lost. Using the 
HOLD macro assures you that once the problem has been corrected, the station 
will receive all traffic directed to it. The message you issue HOLD for in the 
outmessage subgroup will be retransmitted when the HOLD is released. 

You should code at least one HOLD macro in your MCP. If you do not, you will 
not be able to intercept a station with the SUSPXMIT operator command. You 
may make the mask operand an impossible combination of errors, so that HOLD 
never executes. This lets you issue operator commands, which you will need to do 
if a terminal unexpectedly fails and you do not want to lose any messages for the 
station. 



The CANCELMG macro immediately cancels a message if any errors specified in 
the mask operand are also set in the message error record for the incoming 
message. A canceled message does not go to any destination, even if it is a 
multiply-routed message. 

If you execute an INITIATE macro for an incoming message, do not execute a 
CANCELMG macro. CANCELMG is coded in the inmessage subgroup and 
therefore operates on the entire message. However, INITIATE sends each 
segment of a message as soon as possible after it is received at the destination 
queue. Therefore, one or more segments of the message may already have been 
sent before CANCELMG executes. 

CANCELMG must be the first functional macro that you code in the inmessage 
subgroup, and you can execute only one CANCELMG macro for a message. 

Use CANCELMG to be sure that only valid messages are processed. You should 
notify the operator who entered an invalid message (using MSGGEN or ER- 
RORMSG) that the message was not processed and that he must reenter the 
message correctly. 



The REDIRECT macro queues a message for a destination, in addition to the 
destinations specified by the FORWARD macro, when it finds that errors speci- 
fied in the mask operand are present in the message error record for the message. 

Use the REDIRECT macro when you want to return the incorrect message to the 
originating terminal. With REDIRECT, you do not have to code your MCP to 
find the origin field in the header and return the message. TCAM still sends the 
incorrect message to all destinations specified in the header, unless you cancel the 
message. 

Using the REDIRECT macro, you can also send messages to an alternate destina- 
tion when the original station is inoperative. If you have not coded a HOLD 
macro in your system, use REDIRECT to prevent any loss in message traffic. 



The ERRORMSG macro is one of TCAM's most useful macros for alerting you to 
errors in transmitted messages or to trouble in your TCAM system. The ER- 
RORMSG macro sends an error message that you specify to a designated station 
when errors in the mask operand are detected in the message error record for the 
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MSGGEN Macro 



ERRORMSG and MSGGEN 



message. The error message includes the header of the message in error, followed 
by the text that you write. TCAM inserts your message beginning at the current 
location of the scan pointer in the first buffer. See the TCAM Programmer's 
Guide for considerations on overlaying header or data information. 

The ERRORMSG macro places the error message on the destination queue for 
the station that you select to receive the message, and sends it through the outgo- 
ing group of the MH. Therefore, you must be sure that the format of the errone- 
ous message header is compatible with the macros executed in the outgoing group 
that handles messages for the station receiving the error message. You can use 
alternate paths through the MH, by coding the MSGTYPE or PATH macros, so 
that, by distinguishing message types, you will not have to be concerned with the 
header format. 

You should identify the originating station as the destination of the error message. 
You should also notify the operator who entered the message of what was wrong 
with the message and how TCAM is processing it. For example, if an invalid 
origin is detected, you can issue the message 

INVALID ORIGIN - MESSAGE CANCELED - RESEND 

Your message should be meaningful! The message can have a maximum of 255 
characters or two buffer units (2 * KEYLEN= value), whichever is less. This 
count must include all necessary line-control characters. You should include all 
line-control characters (STX, ETX, EOB, ETB, etc.) in all messages or issue the 
MSGFORM macro in the outheader subgroup. 

The ERRORMSG macro also has an EXIT operand that you can code to complete 
error message processing. For instance, you can use this exit to provide the 
terminal operator with the correct input sequence number if he enters an invalid 
number. Figure 18 shows how you can code the routine. 



The MSGGEN macro generates a message that you define if the errors in the 
mask operand are detected in the message error record for the message. The 
generated error message bypasses all normal functions; there is no message 
handler processing, no queuing, no logging, and no buffer requesting. You must 
supply line-control characters. The error message refers to the last transmission 
since the line is never freed in between message transmission and execution of the 
MSGGEN macro. The MSGGEN macro informs you more rapidly than ER- 
RORMSG that you have an error, but it does not return the header. 

If you code MSGGEN in the incoming group, TCAM sends the error message to 
the origin. If you code it in the outgoing subgroup, TCAM sends the message to 
the destination. The maximum length of the error message is 24 bytes. This count 
includes all necessary line-control characters. Again, you should supply all 
line-control characters for all your MSGGEN messages. 



Both macros let you issue error messages. The following chart compares the two 
macros. 
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GETSEQ CSECT 
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Figure 18. An ERRORMSG Macro Exit Routine 



ERRORMSG 

255 bytes or two units — 
maximum message length 

header of message in error 
precedes error message text 

slow — 

message processed by MH 

exit for user-written routine 



MSGGEN 

24 bytes — 

maximum message length 

no header 



immediate response — 
no MH processing 

no exit 



can specify destination of 
generated message 



no choice of destination — 
incoming returned to origin- 
outgoing sent to destination 



This chart shows that the major advantage of using MSGGEN is that it is faster, 
since you do not have to process the header through the message handler. Howev- 
er, you do not have an exit routine, the maximum length is small so it is difficult to 
send meaningful messages, you have no choice of destination, and you do not get 
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Logging 



the header, which can be a valuable tool to trace the message or terminal that 
created an error. 



You can use logging in two ways: first, as an integral part of the system, recording 
messages for accounting; and second, as a programming aid, helping you to 
diagnose errors and to find the information you need to evaluate system perform- 
ance. 

You may want to record all messages for accounting, even though they were 
successfully sent to their destinations. The best way to obtain a meaningful 
accounting report is to either record the entire message (code the LOG macro in 
the inmessage or outmessage subgroup) or to record only the header segment 
(code the LOG macro in the inheader or outheader subgroup). You should record 
only the header segment if you have meaningful data in the header, such as the 
origin, time, date, and destination terminals. Some accounting uses of logging are: 

1. Copying groups of messages sent over a long period of time to a variety of 
destinations. 

2. Providing long-term backup for messages that are accepted by one or more 
destinations but later lost through human error. 

3. Collecting exceptional cases. 

The log is also a good programming aid. If you include a carefully designed 
message-logging facility in your message handler, you can trace the flow of 
messages through your MCP; thus, you can quickly find errors while you are 
diagnosing the MCP. By examining the log, you can see what message handler 
processing has been performed on the message, and locate the subgroup in which 
the message becomes incorrect. 

In your initial stage of programming a TCAM MCP, the use of the OS/360 WTO 
macro interspersed at appropriate points is beneficial in tracing a message through 
message handler processing. 

The log also helps you more efficiently allocate the resources of your telecommu- 
nications system. Do this by analyzing the flow patterns of the message traffic. 
When you first execute the MCP, include the log facility to record such informa- 
tion as time, origin, and destination for each message, or, in cases where traffic is 
heavy, for representative messages. You can then reallocate your resources for 
more efficient processing. 
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TCAM Problem Determination Aids 



This chapter suggests where you can look in your code when you have an error. 
Each possible problem area is discussed. Lists of the more common errors that 
can be made are given. Use this chapter to review your code before you first run a 
TCAM program. Use it also when you have a problem to review possible problem 
areas. 

In addition to errors in your code, this chapter also summarizes other sources of 
errors, such as hardware, software, and those that might be caused by system 
console operators, and terminal users. 

Application Program Considerations 

If you suspect a problem in one of your TCAM application programs, use this 
section to help you find it. The section includes suggestions for coding and 
examining your application programs and their interface with your TCAM mes- 
sage control program (MCP), a summary of message handler macro instructions 
that can affect your application program, and a checklist of common errors to help 
you isolate your problem. An application program is just another terminal as far 
as TCAM is concerned. It is a valid destination for messages, and must have a 
destination queue to which the GET is issued. The location of the queue is 
specified by the QUEUES= operand of the TPROCESS macro. The QNAME= 
parameter on the DD card specifies the name of the process entry with which the 
destination queue is related. 

Examining and Coding an Application Program 

When you begin to write an application program to run as part of a TCAM 
system, you should write your program and its MCP message handlers as simply as 
possible, and use only enough code to establish the TCAM interface and to test 
the transfer of messages or data between your program and the MCP. After you 
have successfully tested the interface, you can easily add more sophisticated code. 

Before you code or diagnose application programs, you should be thoroughly 
familiar with Writing TCAM-Compatible Application Programs in the TCAM 
Programmer's Guide. Study carefully also, the discussion of the LOCK macro and 
how to code it, and how to code DCBs and PCBs, since severe errors can result 
from their misuse or non-use. 

Define and open DCBs for the application program in the application program. 
Test for successful open for every data set (DCB) for which you issued an OPEN 
macro. 

Define one PCB macro in the MCP, not in the application program, for each 
application program. Do not issue an OPEN for a PCB. 

Define one TPROCESS macro in the MCP for each queue used by an application 
program — one for GET or READ, one for PUT or WRITE. More than one 
TPROCESS macro can name the same PCB. If two TPROCESS macros name the 
same PCB, the GET or READ TPROCESS macro must specify the QUEUES= 
operand, and the PUT or WRITE TPROCESS macro must not specify the 
QUEUES= operand. 
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If you will issue operator commands from an application program, you must code 
the ALTDEST= operand on the TPROCESS macro for the PUT or WRITE to 
name the terminal that is to receive replies. Otherwise, any reply to operator 
commands is sent to the dead-letter queue, or, if no dead-letter queue is specified, 
the reply is lost. 

You can run application programs as separate tasks or as subtasks of the TCAM 
MCP, but, in either case, they must have a priority lower than that of the MCP. If 
the application program runs as a separate task, lower its priority with the OS 
CHAP macro. If the program runs as an attached subtask, lower its priority with 
the LPMOD= operand of the ATTACH macro. 

All application programs must follow standard linkage conventions in saving and 
restoring the registers of the calling program, whether the program runs as a 
subtask or as a separate task. 

You must close each application program, since TCAM does not close normally as 
long as there are any open data sets (DCBs) in the application programs. The 
SETEOF macro, used with the EODAD= operand of the application-program 
input DCB macro, is not intended to do this. You can use SETEOF this way, 
however, if you ensure that the DCBs are open when a GET or READ is issued, 
but closed when the closedown command (Z TP) is issued. 

If the application program runs as a separate task, the system operator can close it 
with the CANCEL command. However, if it runs as a subtask, you must close it 
some other way, since the CANCEL command cannot locate the application 
program. One way to close an attached subtask is to have the application program 
test for a special closedown message sent to it by a terminal, and to branch to a 
closedown routine when it receives this message. 

Remember that TCAM sometimes uses part of the work area you defined in your 
application program to pass data to you (see Transferring Data Between an 
MCP and an Application Program in the TCAM Programmer's Guide. This data 
can include the SAM prefix, the position field, and the name of the terminal that 
originated the message. You must not destroy or improperly update these fields. 

For instance, if you specify OPTCD=W in the input DCB macro, TCAM places 
the name of the originating terminal in the first eight bytes of your work area. 
You can send a reply to that terminal by coding FORWARD DEST=PUT in the 
inheader subgroup of the application program message handler. If you code 
OPTCD=W, and the terminal is on a switched line with no ID characters, and if 
no ORIGIN macro identifies the terminal, TCAM has no way of knowing where 
the message was entered. This leaves the eight-byte field blank. Therefore, if you 
code FORWARD DEST=PUT, be sure that the work area is not blank. If you do 
not specify OPTCD= U on your output DCB, the work unit is assumed to be a 
record and TCAM will not transmit the work unit until you have indicated that it 
is an entire message. If you wish to transmit each work unit that you send be sure 
to specify OPTCD=U. 

If you do not use the eight-byte prefix set up by TCAM, then code the destination 
terminal name in the message, just as you would for any terminal, and code a 
normal FORWARD macro in the message handler. 

Any message sent by the application program should include a carrier return and 
an EOT. If you omit the EOT, the terminal will time out waiting for an EOT. 
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Use the MSGFORM macro to insert the EOT character automatically where 
needed. Use of the MSGFORM macro is restricted to the outheader subgroup of 
the message handler and should be the first macro after OUTHDR to assure its 
execution. 

Either messages sent by an application program to a terminal must be coded in the 
line code for that terminal, or you must issue a CODE macro in the outgoing 
message handler for that terminal. If you use line code in your application pro- 
gram, then: 

1. the types of terminals to which you can send messages is limited to those of a 
common line code, and 

2. the chances of error are greatly increased. 

If you use EBCDIC and translate messages to line code with the CODE macro, 
then: 

1. you can send messages to any terminal in the system and 

2. messages are error-free. 

The amount of main storage and time you save by trying to use line code in the 
application program is usually not enough to offset the disadvantages. 

To make your system more efficient, be sure that the work-unit size in the appli- 
cation program is compatible with the buffer size in the MCP. See 
Application- Program Buffer Design Considerations and Transferring Data 
Between an MCP and an Application Program in the TCAM Programmer's 
Guide. Note particularly the restrictions at the end of the latter section. 

If you code any non-TCAM macros (for instance, STAE, SYNADAF, or SY- 
NADRLS), or if you use the SYNAD= or any other exit, read the appropriate OS 
publications. The TCAM Programmer's Guide covers only what affects TCAM. 

Message Handling for an Application Program 

Six message handler macros affect or can affect an application program; seven 
macros cannot be coded in the message handler for an application program. The 
macros that you cannot code are CUTOFF, LOCK, MSGFORM, MSGGEN, 
MSGLIMIT, SCREEN, and UNLOCK. Following is a summary of the macros 
that can affect an application program. 

Macro Function 

CODE Code this macro if you want to issue operator commands in 

your application program. 

COUNTER Use this macro to statistically record message volumes proc- 

essed in your program (such as the total messages in and out, 
data volume handled, types of messages). 

FORWARD Use this macro explicitly if your messages include the destina- 

tion (DEST=**) or, if you define the destination in the PUT 
work-area prefix of your application program, use 
DEST=PUT. 

MSGEDIT Use this macro to deblock output messages going to your 

application program by inserting record delimiter characters 
(as specified in the RECDEL= operand of the TPROCESS 
macro). Use it also to delete insignificant data from input 
messages. 
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PRIORITY The priority level specified places messages on the read-ahead 

queue in priority order. There is no further priority processing. 

SETEOF Use this macro to enter your EODAD routine. The application 

program enters the EODAD routine when it receives the mes- 
sage following the message for which SETEOF executes. 
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Typical Errors 



Right 


Wrong 


YES 


NO 


YES 


NO 


YES 


NO 


NO 


YES 


NO 


YES 


YES 


NO 


YES 


NO 



Following is a list of common errors that can be made in coding an application 
program and its interface in the MCP. It is in the form of questions, with 
YES/NO answers, against which you can examine your code. 

Question 

1. Did you follow standard linkage conventions? 

2. Did you code an OPEN for each DCB? 

3. Did you check each OPEN for successful completion? 

4. Did you issue an OPEN for a PCB? 

5. Did you destroy or overlay your work-area prefix? 

6. Did you code closedown procedures? 

7. Is your work-area size compatible with TCAM buffer 
size? 

8. Are your incoming and outgoing work units YES NO 
compatible? 

9. Is your destination correct for a lock response? YES NO 

10. Did you code the QUEUES= operand of the YES NO 
TPROCESS macro for GET or READ? 

11. Did you include an EOT in every message from your YES NO 
application program or MSGFORM macro in your 

outheader subgroup of the terminal receiving 
the message? 

12. Do your application programs have lower priority YES NO 
than your MCP? 

13. Did you specify a terminal to receive replies from YES NO 
operator commands (in the ALTDEST= operand of 

the TPROCESS macro)? 

14. Did you specify a record delimiter for fixed-length YES NO 
records or messages? 

15. Did you specify enough buffer units? YES NO 

16. Is your work-area size for copy functions large YES NO 
enough when using the TCOPY macro or when 

displaying the option fields by an operator control 
command? 

17. Did you specify a work-unit size for PUT or WRITE? 

18. Did you activate your application program before 
you started your MCP? 

19. Did you omit any DD statements? 

20. Did you specify initiate mode for a single-buffer 
message? 

21. Did you omit the BLKSIZE= operand of the DCB NO YES 
macro for GET in locate mode? 

22. If you are using initiate mode, is the conchars YES NO 
string entirely in the first buffer? 

23. When you are using message processing, did you YES NO 
specify the OPTCD=U operand of the DCB macros? 

24. Did you check all return codes provided by TCAM? YES NO 

25. If you specified OPTCD=W on the INPUT DCB macro, YES NO 
did you make your work unit eight bytes larger 

than the buffer size defined on the DCB macro? 



YES 


NO 


NO 


YES 


NO 


YES 


NO 


YES 
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Message Control Program Considerations 

As a system programmer writing a message control program (MCP), you have five 
basic tasks: 

1. Defining TCAM terminal and line control areas. 

2. Defining the buffers TCAM uses to handle, queue, and transfer message 
segments between communication lines and queuing devices. 

3. Defining TCAM data sets. 

4. Activating and deactivating TCAM and its data sets. 

5. Defining the message handlers, the sets of routines that examine and process 
control information in message headers, prepare message segments for forward- 
ing to the destination, and route messages to their proper destination. The 
following sections are lists of suggestions, considerations, and typical errors in 
each of these coding areas. 

Defining TCAM Terminal and Line Control Areas 

If you suspect a problem in your terminals or lines, review this section to help you 
find it. You should also be familiar with Defining Terminal and Line Control 
Areas and Appendix G. Device-Dependent Considerations in the TCAM 
Programmer's Guide. 

General Hardware Considerations 

You must know your hardware. Incorrect coding of polling and addressing 
characters is a common error. You can find these characters, along with end-to- 
end control sequences, in hardware publications. 

All terminals connected to a given line must have the same characteristics. 

Use transparent mode for BSC devices if you send messages containing binary 
data, fixed- or floating-point data, packed decimal digits, source programs, or 
object decks, because the binary structure of a character may be the same as that 
of a data-link control character. 

TERMINAL Macro Instruction Considerations 

Code a TERMINAL macro for a group entry that represents a group of terminals 
on a line that has the group addressing hardware feature and is for output only. 
Specifying a single set of unique addressing characters sends messages simultane- 
ously to all terminals in the group. If you also want to address or poll a member of 
the group individually, you must code another TERMINAL macro for that entry. 

Code a TERMINAL macro with the operand UTERM=YES for a line entry that 
defines a switched line for input or input/output operations. The stations on the 
line do not necessarily identify themselves when calling the computer. 

Issue TERMINAL macros for stations on the same line together. Do not code 
two TERMINAL macros with different names for the same buffered station, since 
message segments may become intermixed during receiving or sending, and a text 
segment may be treated as a header. 

Specify ALTDEST= in the TERMINAL macro for terminals on reusable disk 
queues. When a reusable disk is cleaned up, TCAM requeues any unsent mes- 
sages in the queue for the terminal specified. If you omit this operand, unsent 
messages on the queue are marked serviced and may be overwritten and lost with 
no error indicated. It is preferable not to specify the alternate destination with the 
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same name as this TERMINAL macro. If you do, and if there is hardware trouble 
on the line, your messages are not lost, but they consume both space on the queue 
and processing time to move them on each cleanup. 



Option Field Considerations 



The OPTION macro specifies the name and type of the option field. It does not 
initialize or allocate storage. The OPDATA= operand of the TERMINAL macro 
initializes the option field for the particular terminal entry. 

You can assign option fields having identical names and attributes but different 
contents to different stations, components, lines, or application programs. 

Example: COUNT OPTION H 

MSGLMT OPTION CL1 

REDRECT OPTION CL3 

ERRMSG OPTION CL4 

The OPTION macros define a 10-byte option area for entries in the terminal 
table. If the OPDATA= operand of terminal A (a 1050) was coded OPDATA= 
(0, 0, NYC, PITT) a 10-byte storage area would be set aside in the option table 
for use by MH macros in handling messages to and from terminal A. The 
COUNT and MSGLMT field would initially contain 0, REDRECT would contain 
NYC, and ERRMSG would contain PITT. If the OPDATA= operand for termi- 
nal B (a 2740) was coded OPDATA= („ALA,CHI), a 7-byte storage area would 
be set aside in the option table for use by MH macros in handling messages from 
terminal B. REDRECT would contain ALA and ERRMSG would contain CHI. 

The order in which you code OPTION macros determines the order in which you 
must code the initial data in the OPDATA= operand of the TERMINAL macros. 

Do not waste space in your option table. For example, if you code 



Other Considerations 



AA OPTION FL1 
AB OPTION CL4 
AC OPTION H 



you waste a byte of storage, since AC must be on a halfword boundary. 



Do not use main-storage-only queuing in a LOGTYPE macro. If the log DCB is 
not open, messages build up in main storage and exhaust your buffer units. 



Typical Errors 



Following is a list of common errors that can be made in coding terminal and line 
control areas. It is in the form of questions, with YES/NO answers, against which 
you can examine your code. 

Question Right Wrong 

1. Does the UCBTYPE field in the UCB for the line in YES NO 
the nucleus specify the correct characteristics for 

the terminal or terminals on the line? 

2. Did you consider device dependencies? (See Appendix YES NO 
G of TCAM Programmer's Guide.) 
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Defining TCAM Buffers 



3. Are your polling and addressing characters YES NO 
correct? 

4. Do all terminals connected to a given line have the YES NO 
same characteristics? 

5. Did you issue TERMINAL macros in a line group YES NO 
together and in ascending relative line sequence? 

6. Did you immediately follow the TERMINAL macro YES NO 
for a station with the TERMINAL macros for the 

individual components of that station? 

7. Did you specify BFDELAY= in the TERMINAL macro NO YES 
for a terminal other than a 2740 Model 2 or a multipoint 

2770? 

8. Did you define a TPROCESS macro for each queue to 
which an application program can issue a GET or READ? 

9. Did you define at least one TPROCESS macro for all 
PUTs and WRITEs from the same application program? 

10. Did you code a name on each OPTION macro? 

11. Do your OPTION macros immediately follow the 
TTABLE macro? 

12. If you have OPDATA= defined in the TERMINAL YES NO 
macro, did you replace option fields not defined 

for the particular entry with a comma 
(except trailing commas)? 

13. Is the BUFSIZE= operand of the LOGTYPE macro YES NO 
a multiple of the value specified in the KEYLEN= 

operand of the INTRO macro? 

14. Does the NCP= operand of the LOG DCB have a YES NO 
value which is at least the number of units in the 

buffer you are going to be logging? (NCP= is the 
number of writes before a check.) 



YES 


NO 


YES 


NO 


YES 


NO 


YES 


NO 



If you suspect a problem in your buffers, review this section to help you find it. 
You should also be familiar with Defining Buffers in the TCAM Programmer's 
Guide. 

Remember that a buffer is made up of one or more buffer units. A buffer unit can 
be between 35 and 255 bytes, and a buffer can be between 35 and 65535 bytes. 

Use larger buffers (more units per buffer) because: 

1. Fewer buffers are required for a message. Therefore, TCAM requires less 
overhead to manipulate buffers. 

2. When you use dynamic buffer allocation (PCI), the possibility of losing data 
because of a delayed PCI is decreased. 

3. The number of PCIs required, if PCI is specified, is decreased. 

4. You make better use of the TCAM disk accessing method (multiple-arm 
support), because there is a larger number of contiguous records than there 
would otherwise be. 

5. There are fewer queuing operations per quantity of data; this saves time. 

Use smaller buffers (fewer units per buffer) because: 
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1. Units in smaller buffers return to the available-unit queue more rapidly than 
units in larger buffers, since it takes less time to empty and fill a smaller buffer. 
Therefore, you can have a smaller unit pool since allocation of resources occurs 
more frequently. 

2. TCAM's work load is broken into smaller pieces, resulting in a more equitable 
allocation of processing time among message segments in main storage. 

Use more units in the system because: 

1. You are less likely to lose message data coming in over a line. 

2. You are less likely to delay outgoing messages due to waiting for a buffer. 

Use fewer units in the system because: 

1. Main storage is used more efficiently. Since the number of units in the free 
pool is not excessive, you save main storage. 

Use larger units because: 

1 . Disk space is used more efficiently, since there are fewer interrecord gaps. 

2. The area available for text compared to the area containing management 
information is relatively large. 

3. Since more data is transmitted per CCW on lines and disk, the channel activity 
is relatively light; this saves channel fetch and CPU time. 

4. You need fewer channel program blocks (CPBs) to transfer the same amount 
of data to and from disk; this saves storage space and time, since there is less 
CPB queuing. 

Use smaller units because: 

1. Duplicate headers, used for multiple routing of messages, take up relatively 
little room. 

2. You can specify a relatively large range of buffer sizes without wasting space in 
main storage and on disk. 

3. You can reallocate buffers more frequently with smaller units, since they pass 
through the system more rapidly than larger units. 

Use dynamic buffer allocation because: 

1. When you code PCI=A, fewer buffers are assigned initially to a line, since 
dynamic allocation brings the number of buffers assigned up to the value 
specified by BUFMAX= and maintains this number if possible. 

2. When you code PCI=A and a negative response to invitation occurs, only the 
number of buffers assigned initially, rather than the maximum number assigned 
to the line, have been fruitlessly allocated. 

3. When you code PCI= as A or R, buffers are continuously deallocated. The 
free-unit pool is therefore continuously being replenished, and a smaller unit 
pool is required. 

4. When you code PCI= as A or R, a message moves one buffer at a time; there- 
fore, fewer CPBs are required to achieve the same performance. 

Use static buffer allocation because: 

1. Dynamic allocation and deallocation of buffers takes processing time. 

2. When you use reusable disk queues, records written to disk by the PCI inter- 
rupt are not serviced until the entire message is queued. If the length of time 
required to enter a message is excessive, or if reusability servicing is very 
frequent, records may be overlaid. If this occurs, TCAM terminates abnormal- 
ly with a system code of 045 and a return code of 02 or 03 in register 15. 
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For start-stop lines using dynamic allocation, if you specify BUFIN=2, 
BUFMAX=2, dynamic allocation may be inefficient. 

The number of buffers you assign initially to each line (BUFIN= and BUFOUT= 
operands) depends on: 

• terminal type, 

• terminal speed, 

• line speed, 

• whether dynamic allocation of buffers is specified. 

The faster the data is transmitted, the higher the initial assignment should be. 

For high-speed BSC lines, dynamic allocation may not be totally effective; that is, 
there may not be a one-to-one correspondence of replacement buffers to replaced 
buffers. 

Remember that a line does not have both BUFIN= and BUFOUT= assigned at 
the same time. In deciding how many units to define, you need be concerned only 
with the initial requirements for send or receive operations. A formula to approxi- 
mate how many units you need in your system is: 

1. Determine for each line the maximum, average, and minimum message length. 

2. Select the optimum buffer size for each line group for input and output. 

3. Based on all line group buffer sizes, select an optimum unit size for the message 
control program. 

4. Based on optimum unit size, re-specify buffer sizes for each line group to more 
efficiently utilize the units. 

5. To Determine the maximum line units required for all lines, take the sum of the 
product of the maximum number of buffers for each line multiplied by the 
quotient of buffer length divided by unit length. 



LNUNITS = 2 



Maximum" 
Number 
of Buffers 
Per Line 



Buffer Length 



Unit Length 



If you use disk queuing, try to make the buffer size specified by the source of a 
message equal to the buffer size specified by the destination. When the buffer 
sizes specified for the origin and destination are different, data movement occurs 
because TCAM must add Or delete prefixes when it places the message in the 
buffers for the destination. Moving data takes time. 

Remember that BUFIN= or BUFOUT= is satisfied when a line is opened active. 
When you start an operation and have dynamic buffering, BUFMAX= is satisfied. 
Do not be frugal with your unit-pool size. If you are, you degrade your system, 
since TCAM does not have enough buffer units to perform adequately. 

Operator commands from stations and application programs must be contained in 
a single line buffer; if the buffer is too small, the command is truncated and an 
attempt is made to process it. 

You can spot unused buffer units in the buffer-unit pool because they have only 
the link field filled in the prefix. The remainder of the buffer prefix and unit are 
zeros. 
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Typical Errors 



Following is a list of common errors that can be made in defining buffers. It is in 
the form of questions, with YES/NO answers, against which you can examine 
your code. 

Question Right Wrong 

1. To save main storage, is 12+KEYLEN=evenly YES NO 
divisible by eight? 

2. Is the BUFSIZE= operand on the DCB macro evenly YES NO 
divisible by the unit size specified in the KEYLEN= 

operand of the INTRO macro? 

3. Did you allow room for the buffer prefix (30 bytes YES NO 
for a header buffer and 23 bytes for a text buffer)? 

4. Is each buffer unit at least 35 bytes and no YES NO 
longer than 255 bytes (not counting the 12-byte 

control area that TCAM adds)? 

5. Is each buffer at least 35 bytes and no longer YES NO 
than 65535 bytes? 

6. For BSC lines using dynamic allocation, YES NO 
did you code the BUFMAX= operand at least two 

greater than the larger of BUFIN= or BUFOUT=? 

7. IsBUFMAX>BUFIN/BUFOUT? YES NO 

8. Are your buffers long enough to hold an operator YES NO 
control command? 



Defining TCAM Data Sets 

If you suspect a problem in your data sets, review this section to help you find it. 
You should also be familiar with Defining the MCP Data Sets in the TCAM 
Programmer's Guide. 



Line Group 



A line group may consist of from one to 255 lines. The size of a line group is 
limited by the fact that the INVLIST= operand of the DCB macro can be no 
longer than 255 characters, including commas; thus you cannot have 255 invita- 
tion lists for a line group. 

All lines in a group must have the following common characteristics: 

1. All must be switched or all must be nonswitched. 

2. All use start-stop or all use binary synchronous transmission. 

3. All lines are associated with stations having the same device characteristics. 

4. All use the same invitation delay. 

5. All use the same message handler. 

6. No line in the group is a member of another group. 

7. All are preassigned the same number of buffers to handle initial segments of 
incoming messages. 

Be aware of the A/B suboperands on the INVLIST= operand if you use a 2701 
Transmission Control Unit. 

Any number of output-only lines may refer to the same invitation list name. 

The RESERVE= operand reserves space in incoming header units and text units, 
although data may be inserted in either the incoming or outgoing message handler. 



TCAM Problem Determination Aids 49 



Message Queues 



IT = 


015 


IT - 


016 


IT = 


017 



If there is not enough space (if BUFSIZE= is too small), the macros that insert 
data (DATETIME, SEQUENCE) do not execute. 

Be sure you use the right translation table, and know its characteristics. For 
instance, a folded table recognizes both uppercase and lowercase letters as valid. 

You must code the SCT= operand if you specify your own table in the TRANS= 
operand. The SCT= operand must be a valid TRANS= entry. You cannot 
specify your own special characters table. 

When you concatenate DD statements for a line group, their arrangement deter- 
mines the relative line numbers of the lines. The relative line number is a number 
assigned by you to a communications line of a line group at system generation 
time or MCP execution time. If a line group is defined at system generation time 
by the UNITNAME macro, the lines in the group are assigned relative line 
numbers according to the order in which their hardware addresses are specified in 
the UNIT= operand; the line whose address is specified first is relative line one, 
the address specified second is relative line number 2, etc. If a line group is 
defined at MCP execution time by concatenated DD statements, the arrangement 
of the DD statements determines the relative line numbers for the lines. 

Example: //GROUPONE DD 

// DD 

// DD 

Line 015 is RLN=1, line 016 is RLN=2, and line 017 is RLN=3. Since RLN= 
operand is assembled in your MCP in the TERMINAL macro, the order of the 
DD cards cannot be disturbed. If one is removed, a dummy must replace it. 

Do not have more DD cards than INVLIST = operands in the DCB. 



Remember that one channel program block (CPB) is involved whenever the 
contents of a buffer unit are written to disk or read from disk. The number you 
need depends on the amount of message traffic during the peak period of activity 
for the TCAM system. 

Too few CPBs cause poor disk performance. Messages are delayed while TCAM 
waits for CPBs to become available to place the messages on or remove them from 
disk. 

Too many CPBs waste main storage. 

To investigate CPB availability, AVT+X'46C points to the first entry in the CPB 
free pool. The thirteenth word points to the next lower CPB entry on the queue. 
In a dump, if the first few words of the CPB are zero, then that CPB and all that 
follow are unused. If no CPBs are zero, then you probably need more CPBs. 

When you pref ormat your disk data set, using utility IEDQXA, be sure that the 
KEYLEN= operand is the same as that specified on the INTRO macro when you 
attempt to open the data set. 

You increase disk efficiency if you space disk message queues data sets over 
several volumes. 
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Checkpoint and Log 



Typical Errors 



On the DCB macro for a message queues data set, be sure that the OPTCD= 
operand has the correct specification: 

OPTCD=L for nonreusable disk data sets 
OPTCD=R for reusable disk data sets. 



In the DD statement for the checkpoint data set, if you specify DISP=NEW, you 
will always get a cold restart. 

If you log both messages and message segments, define two separate data sets. 
You can have only one LOGTYPE macro per DCB. 



Following is a list of common errors that can be made in coding DCBs for TCAM 
data sets. It is in the form of questions, with YES/NO answers, against which you 
can examine your code. 

Question 

1 . Did you specify one line group DCB macro for each 
line group in the system? 
(Does each line have a DCB associated with it?) 

2. Do you have more than 255 lines in a line group? 

3. Are the BUFIN=, BUFOUT=, and BUFMAX= 
operands of the DCB all specified from the same source? 



Right 
YES 



NO 

YES 



Wrong 
NO 



YES 
NO 



4. Are the listnames in the INVLIST= operand YES NO 
specified according to ascending relative line 

numbers of the lines in the group? 

5. Is there one invitation list name in the YES NO 
sublist for each line in the line group? 

6. Did you include framing parentheses in the PCI= YES NO 
operand (for instance, PCI=(A,A))? 

7. If you specify CPRI=R and you want to YES NO 
send output messages to the terminal, did you code a 

polling interval delay in the INTVL= operand? 

8. Did you include at least one DD statement for each YES NO 
line group data set? 

9. Did you specify at least two CPBs for reusable disk YES NO 
queuing? 

10. Did you specify at least one CPB for nonreusable YES NO 
disk queuing? 

11. Do you have at least as many CPBs as the maximum YES NO 
number of buffer units per buffer in the system 

(so that an entire buffer can be dispatched with 
a minimum number of operations)? 
12.1s the KEYLEN= operand on the log data set DCB YES NO 

macro the same as the KEYLEN= operand on the 
INTRO macro? 
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Activating and Deactivating TCAM 

If you suspect a problem in activating or deactivating TCAM, review this section 
to help you find it. You should also be familiar with Activating and Deactivating 
the Message Control Program in the TCAM Programmer's Guide, GC30-2024. 



INTRO Macro 



OPEN Macro 



Do not code the INTRO macro until you have read the sections in the TCAM 
Programmer's Guide for the functions to which the operands refer. 

You should allow for a dynamic INTRO macro by omitting one of the following 
operands when you assemble: 

STARTUP= 

KEYLEN= 

LNUNITS= 

if DISK=YES, CPB=. 

In response to the message 

IED002A SPECIFY TCAM PARAMETERS 

each response can be a maximum of 41 characters. You keep getting the same 
message until you specify 'U', which indicates that you have no more operands to 
enter. 

If you still omit one of the four required operands, TCAM tells you the specific 
operand missing. 

An error in a keyword for an operand in the reply prevents interpretation of any 
keywords in the same response to the right of the keyword in error. 

MSMIN= must be less than MSMAX= or the INTRO macro does not execute. If 
you change these values at execution time, the value is compared to the current 
values, if specified, to see that the rule is not broken. If you specify at assembly 
time 

MSMAX=90 ,MSMIN=85 
and at execution time 

MSMIN=95 , MSMAX=99 
INTRO will not execute because 95 is greater than 90. 

You should specify the operands that provide the trace tables: 

CROSSRF= 

TRACE= 

DTRACE= 

You should provide a dead-letter queue (DLQ=) for your network. 

Be sure to check the return code after the INTRO macro executes. If it is any- 
thing other than zero, the MCP is unlikely to work satisfactorily, and you should 
deliberately ABEND in the MCP. 



Opening a line group data set causes all lines in the line group to be prepared for 
operation. You can defer activation until later by opening the line idle and later 
issuing the STARTLINE operator command. 
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Open your data sets in the correct order: 

First: message queues data sets 

Next: checkpoint data set 

Last: line group and log data sets 

If you open a large number of data sets, you must be conscious of the base 
register. You can use the following procedure before your first OPEN macro. 



BASE 



DC 
L 

USING 
OPEN 



A( DCBSTART ) 
2, BASE 
DCBSTART, 2 



DCBSTART 



DROP 

EQU 

DCB Macros 



READY Macro 



CLOSE Macro 



Typical Errors 



Check each OPEN to see if it was successful (test DCBOFLAGS at DCB+X'48' 
with a mask of X'10'), and inform the system console of the result of the test. 
This provides immediate information about the status of your network. You will 
know if all your data sets were opened, and eliminate useless diagnosing of an 
error caused by an unopened data set. A recommended procedure is 



OPEN (DISK, ( INOUT) ) 

TM DISK+48,X' 10' 

BO NEXT 

WTO 'REUSABLE DISK NOT OPEN' 

NEXT OPEN ( DCB1 050, ( INOUT) ) 

TM DCB1050+48,X' 10' 

BO NEXT1 

WTO '1050 DIAL LINE NOT OPEN' 
NEXT1 .... 



Remember that "good morning" and "restart in progress" messages pass through 
the outgoing message handler, and need an appropriate header. 

After READY executes, TCAM is ready for message processing. 



The CLOSE macros must follow the READY macro or be branched to from 
instructions immediately following READY. 

Be sure you close your data sets in the correct order: 

First: line group and log data sets 
Next: checkpoint data set 
Last: message queues data sets 



Following is a list of common errors that can be made in coding the activation and 
deactivation section of an MCP. It is in the form of questions, with YES/NO 
answers, against which you can examine your code. 
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Queuing 



Question Right Wrong 

1 . Do the INTRO, OPEN, and READY macros precede the YES NO 
message handler sections of the MCP? 

2. Do any instructions that you coded before the INTRO NO YES 
macro contain any TCAM macros? 

(INTRO expects to be first. 

It gets control from BALR 14, 15 

with the save area set. It expects to get control from OS.) 

3. Did you specify both the KEYLEN= and the UNITSZ= NO YES 
operand for the buffer-unit size? 

4. Is MSMIN= less than MSMAX=? YES NO 

5. DidyoucodeFEATURE=(„TIMER)if you use any of YES NO 
the following functions: checkpoint, any interval, 

dial-out options, main-storage queuing, reusable 
disk queuing? 

6. Did you check the return code after the INTRO macro YES NO 
executes? 

7. Are your OPEN macros in the correct order (disk YES NO 
data sets, then checkpoint data set, then line group 

and log data sets)? 

8. Did you check each OPEN to see if it was successful? YES NO 

9. Before you closed TCAM, were all data sets for YES NO 
application programs closed (for instance, with a special 

message)? 

10. Does the deactivation section of your MCP end with YES NO 
a RETURN macro? 

11. Did you prepare for the return by loading register YES NO 
1 3 with the save area address? 

12. Are your CLOSE macros in the correct order (line YES NO 
groups and log data sets, then checkpoint data set, 

then disk data sets)? 



If you suspect a problem in queuing, review this section to help you find it. You 
should also be familiar with Defining the MCP Data Sets in the TCAM 
Programmer's Guide. 



Main-Storage Queues 

Main-storage-only queuing is the fastest method in response time, but it uses more 
main storage than any other method. 

For main-storage-only queuing, when you use a distribution list, the multiple 
routing and redirect routines place another copy of the header buffer in main 
storage for each station in the list. 

Avoid main-storage queuing for a log data set if at all possible, as it can use up 
your main-storage buffer units (MSUNITS) very quickly, especially if the log data 
set is not open or going directly to the printer. 



Nonreusable Disk Queues 



Nonreusable disk queuing requires more space on the disk than reusable queuing. 

Nonreusable disk queuing may require periodic system closedown to clean up the 
disk queues. If the nonreusable disk queue fills up and the closedown fails be- 
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Reusable Disk Queues 



Queuing by Line 



Queuing by Terminal 



Other Considerations 



cause the message TCAM was receiving was too big to fit in the remaining space 
on the disk, TCAM terminates abnormally with a system code of 045. 



Reusable disk queuing requires periodic reorganization. Response time during 
reorganization may be longer. 

Reusable disk queuing can often handle the same amount of message traffic as 
nonreusable queuing, while occupying less disk space. 

Messages that are unsent and have no alternate destination are lost when the 
reusable disk data set is reorganized. 

Message queues on reusable disk never run out of space under normal conditions. 

You can compromise by specifying main-storage queuing with backup on reusable 
disk. This preserves most of the advantages of disk queuing, while achieving a 
faster response time than with disk queuing alone. 

You limit TCAM's capability to retrieve messages that have already been sent 
when you use reusable disk queuing, because the original copy of a transmitted 
message is eventually overlaid by another message. 



If you queue by line, you can send messages by priority on a line basis to stations 
on a multipoint nonswitched line. All messages of a given priority on the queue 
are transmitted before any message of a lower priority, whether or not the higher- 
priority messages are destined for two different stations on the line. 

If you queue by line, you need less storage than if you queue by terminal. If you 
queue by line rather than by terminal, you save at least 65 bytes for each station 
after the first on a line, plus about 28 bytes per station after the first for each 
priority level specified beyond one. 

If you queue by line, you will switch between stations on the line rather than 
maintain connection with a station. 



You must specify queuing by terminal for switched stations and for buffered 
terminals. If you queue switched stations by line, a station that calls in receives 
not only its messages, but those for all other stations in the line group as well. 

If you queue by terminal, you can send messages by priority on a station-by- 
station basis. All messages in a given queue for a station on a line are transmitted 
before any messages in other queues for the remaining stations on the line are 
transmitted, whether or not the other queues contain messages with priorities 
higher than those for the messages being transmitted. 

If you queue by terminal, you need more storage than if you queue by line. 



You use more main storage by mixing queue types than by specifying only one 
queue type for all terminals. 
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Typical Errors 



A segment for which the INITIATE macro has been executed is treated as if it 
were a completed message having the highest priority on the queue, and is sent 
before any other message on the queue is sent. In addition, no message on the 
queue is sent until all segments of the message for which INITIATE was executed 
have arrived at the queue and been sent to their destination. 

Disk queuing ties up disk space and disk channels that could otherwise be used by 
other jobs. 

Following is a list of common errors that can be made in defining queues. It is in 
the form of questions, with YES/NO answers, against which you can examine 
your code. 

Question Right Wrong 

1. Have you specified the type of disk queuing you YES NO 
want (the OPTCD= operand on the DCB macro specifies 

the type; L is nonreusable and R is reusable)? 

2. Did you try to use the HOLD macro with main-storage- NO YES 
only queues? 

3. Did you try to retrieve messages from main-storage- NO YES 
only queues? 

4. Did you try to take checkpoints of main-storage- NO YES 
only queues? 

5. Did you specify queuing by terminal for switched YES NO 
stations or for buffered terminals? 

6. If you are using main-storage queuing with disk YES NO 
backup, did you define at least two message queues 

data sets, one residing in main storage and the other 
on reusable or nonreusable disk? 

Defining the Message Handlers 

If you suspect a problem in a message handler, review this section to help you find 
it. You should also be familiar with Designing the Message Handler in the 
TCAM Programmer's Guide. 



Delimiter Macros 



Message Format 



The STARTMH macro identifies the beginning of a message handler (MH). 
You may omit either the incoming or the outgoing group of the message handler. 

Remember: 

1. INHDR and OUTHDR handle only those message segments that include all or 
part of a message header. 

2. INBUF and OUTBUF handle all message segments. 

3. INMSG and OUTMSG execute after the complete message has arrived at the 
CPU or been sent. 

You can code one and only one INEND and OUTEND macro in an MH. 



Depending on the application, messages may consist of a header only, text only, or 
header and text. You determine what is header and what is text. 
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Scan Pointer 



You should design your message format so that each message starts with a specific 
character (any character will do). Otherwise, carrier returns, spaces, etc., entered 
before the actual message, make it virtually impossible to find the start of data. 
You will find that most terminal operators return the carriage several times to 
assure themselves that the terminal is turned on and working. If your message 
format starts with an X, a sample sequence might be: 

INHDR 

CODE 

SETS CAN C'X' 

You have now passed over any miscellaneous characters that may have been put 
on the line before your message, and you know exactly where valid data starts. 

You should include in your message format an end-of-address (EOA) character to 
allow you to route messages to multiple destinations. (This EOA is not to be 
confused with the hardware-generated line-control character). This also gives you 
another landmark that you can use to separate the actual text of the message from 
its header. You must have an end-of-address for multiple routing. Your message 
format might be 

X origin destl dest2 dest3 / . . . text . . . EOT 

where / is the EOA character. 



The scan pointer maintained by TCAM points to the current field in the message 
header. Since some macros use the pointer to locate the field on which they act, 
you must be aware of the scan pointer position when designing your message 
handlers. Macro instructions in a message handler should be placed in the same 
order within a subgroup as the fields of the header on which they act. The scan 
pointer controls access to these fields, processing across the header from left to 
right as the various macro instructions are executed. 

Note 1: If you code LC=IN in the STARTMH macro and plan to issue 
operator commands from remote terminals, you must move the scan pointer to 
the first data byte before issuing the CODE macro. Example 1 shows 
incorrect code. 



Example 1: 



The MH is coded 

STARTMH 

INHDR 

CODE 



LC=IN 



CONTROL=OPID is coded in the INTRO macro. 

The operator command 

OPID V 01C,ONTP 

is issued from a 1050 terminal. 
The buffer has the following format: 



Unit Control 
Area 


Buffer 
Prefix 


® 


OPID V 01C.ONTP ® © 



t 

position of scan pointer 

The CODE macro determines if the message entered is an 
operator command by matching the characters specified on 
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the CONTROL= operand with the character string following 
the scan pointer. A valid match will not be detected since the 
CODE macro compares ®OPI with OPID. To be correct, the 
MH should be coded as shown in example 2. 



Example 2: 



STARTMH 
INHDR 
SETSCAN 
CODE 



LC=IN 
1 



The buffer will now have the following format. 



Unit.Control 
Area 


Buffer 
Prefix 


® 


OPID V 01C.ONTP (|) © 



position of scan pointer 

Note 2: When a message segment is received for processing in an incoming 
group of a message handler, the space reserved for expansion by the 
RESERVE= operand of the line group DCB or PCB macro is moved to 
the front of the segment and the scan pointer is positioned to the last 
reserved byte. 

Example 3: RESERVE=23 specified in the line group DCB for the line that 
sent the message. 



12 


30 


23 




Unit Control 
Area 


Buffer 
Prefix 


Reserve Data 
Bytes 



position of scan pointer 

If no reserve bytes are specified, the scan pointer points to the last byte of the 
buffer prefix. 



No reserve bytes 
12 



30 



Unit Control 
Area 


Buffer 
Prefix 


Data 



Example 4: 



position of scan pointer 

When a message segment is received for outgoing processings the scan 
pointer is positioned to the last remaining reserve byte, if there are 
unused bytes (example 3). 

If there are no more unused reserve bytes or none originally specified, 
the scan pointer points to the last byte of the buffer prefix (example 4). 

The position of the scan pointer after execution of the STARTMH macro 

depends on the coding of the LC= operand. 

If LC=IN is coded, the scan pointer is positioned to the first 

line-control character. 

If LC=OUT is coded, the scan pointer points to the first data text byte. 

The following is a list of macros that use the scan pointer. 

The scan pointer location is the starting position for macro execution. 

Specific uses are indicated for some macros. 
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The position of the scan pointer after macro execution is also shown. 
Macro Specific Use 



CODE 



DATETIME 



ERRORMSG 



FORWARD 



INITIATE 

LOCK 

MSGEDIT 

MSGTYPE 
ORIGIN 

PATH 
PRIORITY 



SCREEN 
SEQUENCE 



For operator control checking 
on the first incoming buffer 



To insert error text 
after header 

If DEST=** or DEST=(number) 
is coded 



If control characters are used 

If control characters are used 

If AT=SCAN 
IfTO=SCAN 



If control characters are used 

If the priority is in the header 
or if control characters are used 



If control characters are used 



SETEOF 



If control characters are used 



Position of Scan Pointer 
After Macro Execution 

Unchanged 



Unchanged (points to last 
character of inserted data) 

End of error text 



Last character of 

destination 

or EOA character if 

multiple destinations, 

or last character of 

character string 

See Note 3. 

See Note 3. 

See Note 4. 

See Note 3. 

Last character in 
character string 

See Note 3. 

1. Last character of 
priority if priority 

is in the header with 
no character string 
or matched character 
string 

2. Last character of 
control characters if 
priority is in the 
macro 

See Note 3. 

1. Unchanged if output 

2. Last character in 
sequence number if 
input 

See Note 3. 
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User Code 



SETSCAN 1. Unchanged if 

MOVE=RETURN 

2. n characters forward 
or backward 

3. Last character in 
character string 

UNLOCK If control characters are used See Note 3. 

Note 3: 

/. The position of the scan pointer is unchanged if an invalid or no 

condition is given. 
2. The scan pointer points to the last character in a character string if 

a valid condition is given. 

Note 4: 

1. MSGEDIT functions performed on the buffer contents to the left of 
the scan pointer position before macro entry: 

a) possible physical scan pointer movement 

b) no logical scan pointer movement 

Scan pointer before MSGEDIT 
I AAABBBCCCCCX X I 

position of scan pointer 
MSGEDIT replaces AAA with ZZZZ and removes BBB 
Scan pointer after MSGEDIT 

I zzzzcccccx X I 

position oyscan pointer 

2. When MSGEDIT functions are performed on buffer contents to the 
right of the scan pointer position before macro entry, there is no 
physical / logical scan pointer movement. 

Be aware of multiple-buffer header processing across buffers (see Figure 
19). Try to limit your header to one buffer. 

You can vary the path of a message through an MH dynamically using the PATH 
or MSGTYPE macro. The PATH macro controls the routing of a message among 
subgroups. The MSGTYPE macro controls the path of a message within a 
subgroup. 

When you use a character string to control macro execution, do not have partially 
identical strings, such as: 

MSGTYPE ABC 
MSGTYPE AB 

You should cancel all messages that are in error due to inheader processing and 
validity checking. 



You can include either open or closed subroutines in your message handler. 

Avoid system macros that issue an SVC, unless you are fully aware of the implica- 
tions of using such macros in a TCAM system. This is especially true if the macro 
has an implied WAIT state in its execution. 
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Inheader and 

Oufheader 

Macros 


Does Not 
Effect Buffer 
Contents 


Will Cross 
Buffers 


Will Not 
Cross Buffers 


Conditional 
(Note 1) 


CHECKPT 


X 








CODE 


(Note 2) 








COUNTER 


X 








DATETIME 


X 








FORWARD 




(Note 3) 


DEST in message 




INITIATE 








X 


LOCK 








X 


LOCOPT 


X 








LOG 


X 








MSGEDIT 






X 




MSGFORM 


X 








MSGLIMIT 


X 








MSGTYPE 








X 


ORIGIN 




(Note 4) 






PATH 








X 


PRIORITY 




(Note 5) 






SCREEN 








X 


SEQUENCE 


output 
only 




input 
only 




SETEOF 








X 


SETSCAN 




chars 


integer 

POINT=BACK 
chars, RETURN= 




TERRSET 


X 








UNLOCK 








X 



Note 1: Will cross if conchars is not specified, or if entire character 

string is in a subsequent buffer. 
Note 2: Except that an operator command must be complete in a single 

buffer. 
Note 3: Will cross if destination is in the macro or an option field and 

the macro is executed for the first buffer. 
Note 4: Will cross but origin may not be known on dial lines for first 

buffer. 
Note 5: Will cross if conchars not specified and priority level is in 

macro. 

Figure 19. Multiple-Buffer Header Processing Across Buffers 
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Typical Errors 



You can include TCAM macros in an open subroutine; you cannot include them in 
a closed subroutine. 

When your MH handles messages with multiple-buffer headers, any code within 
the inheader and outheader subgroup should test register 15 for a negative return 
code before executing any open subroutines or before branching to a closed 
subroutine if the routine to be executed depends on certain data being in the 
buffer or on the location of the scan pointer. 



Following is a list of common user code errors. It is in the form of questions, with 
YES/NO answers, against which you can examine your code. 



NO 



Question 

1. If you included a subroutine is it serially reusable? 

2. Did you include executable code with an inmessage or 
outmessage subgroup or between such subgroups? 

3. Did you do anything that relinquishes control in a 
subroutine? 

4. Did you include TCAM macros in a closed subroutine? 

5. Did you supply your own linkages and save and restore 
registers in a closed subroutine? 

6. Did you branch from one MH to another? 

7. If you have code in an inheader or an outheader 
subgroup that may handle multiple-buffer headers, did 
you code USEREG= operand in the INTRO macro? 

8. If register 13 is used in an open subroutine, did 
you save and restore its original contents? 

9. In an open subroutine, did you alter the base register? 

If you plan to test the return codes from TCAM macros, see Figure 20 
test, such as testing the return code in register 15 when it is in another 
can cause incorrect processing of a message. 



Right 


Wrong 


YES 


NO 


NO 


YES 



YES 



NO 



YES 



NO 


YES 


YES 


NO 


NO 


YES 


YES 


NO 



NO 

YES 

. A bad 
register, 



Functional Macros 



You must include the CODE macro if you plan to enter operator commands from 
terminals or application programs. 

If you code LC=OUT on the STARTMH macro, issue CODE as the first function- 
al macro in the inheader subgroup for a line on which operator commands may be 
entered. 

Your error message should contain some indication as to whether the error 
occurred in the incoming or outgoing group. 

Remember that the maximum length of an error message created by MSGGEN is 
24 bytes. 

When you generate messages for BSC and 2260 Local terminals, be sure to 
include the STX in the error message. 

Use the ERRORMSG and MSGGEN macros to keep the terminal operator aware 
of the status of his messages (were they canceled? rerouted? why?). 

Make your error messages meaningful. 
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The table below lists those TCAM macros whose return codes may 
be checked by user code in a Message Handler. The return code 
occupies the low-order byte in the register indicated; the rest of 
the register normally contains all zeros. Return codes of X'FC 
are negative return codes; the high-order three bytes of the 
register contain binary ones. Some macros also return an address 
in a register; the locations and nature of such addresses are also 
indicated in the following table of MH macro return codes. 



Macro 


Register 


Return 
Code 


Meaning 


COUNTER 


15 
15 


X'OO' 
X'FF' 


Good return 

Option field not found 


DATETIME 


15 
15 


X'OO' 
X'04' 


Good return 

Insufficient reserve characters 


FORWARD 


15 
15 


X'OO' 
X'04' 


Good return 
Invalid destination 


LOCK 


15 
15 
15 


X'OO' 
X'04 1 
X'08' 


Good return 

Destination not specified 
Destination not a process entry 


LOCOPT 
a) if return 
requested in 
R15 


15 
15 


Address 
of option 
field. 
X'OO' 


Good return 

Option field not found 


b) if return 
requested 
in user- 
specified 
register 
(USEREG) 


15 
USEREG 

15 
USEREG 


X'OO' 

Address 

of option 

field. 

X'04' 

Unchanged 


Good return 

Option field not found 


LOG 


15 
15 


X'OO' 
X'04' 


Good return 

DCB or LOGTYPE entry named 

in macro not found 


MSGEDIT 


15 
15 


X'OO' 
X'04' 


Good return 

No units available 


MSGLIMIT 


15 
15 


X'OO' 
X'04' 


Good return 

Option field not found 


ORIGIN 


15 
15 


X'OO' 
X'04' 


Good return 
Invalid origin 


SCREEN 


15 
15 


X'OO' 

Function 

byte 


Function not done 
Good return 



Figure 20. MH Return Codes (Part I of 2) 
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SEQUENCE 
a) macro 
issued in 
inheader 
subgroup 



15 X'OO' Good return 

15 X'04' Sequence number in message 

high 
15 X'08' Sequence number in message 

low 
15 X'OO Originating station unknown 



b) macro 


15 


X'OO' 


Good return 


issued in 


15 


X'04' 


Insufficient reserve characters 


outheader 








subgroup 








SETSCAN 








a 1) locate 


15 


Address 


Good return 


specified 




of last 




character 




character 




string 




in string 




and return 


15 


X'OO 1 


Specified character string not 


address in 






found in this buffer 


R15 










15 


X'FC 


Scan pointer beyond end of 
buffer 


a 2) locate 


15 


X'OO' 


Good return 


specified 


USEREG 


Address 




character 




of last 




string 




character 




and return 




in string 




address in 


15 


X'04' 


Specified character string not 


user- 


USEREG 


Unchanged 


found in this buffer 


specified 








register 








(USER EG) 










15 


X'FC 


Scan pointer beyond end of 




USEREG 


Unchanged 


buffer 


b 1) skip 


15 


Address 


Good return 


n^ characters 




or character 




and return 




skipped to 




address in 




X'OO' 




R15 


15 




ji greater than the number of 
characters remaining in this 
buffer 


b 2) skip 


15 


X'OO' 




n characters 


USEREG 


Address 




and return 




of character 


Good return 


address in 




skipped to 




user- 








specified 


15 


X'04' 


jn greater than the number of 


register 


USEREG 


Unchanged 


characters remaining in this 


(USEREG) 






buffer 


c) skip 


15 


X'OO' 


Good return 


_n characters 


15 


X'04' 


_n greater than the number of 


backward 






characters preceding the scan 
pointer in this buffer 


d) Locate 


15 


Address 


Good return 


scan pointer 




of scan 




address 




pointer 






15 


X'FC 


Scan pointer beyond end of 
buffer 



Figure 20. MH Return Codes (Part 2 of 2) 
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If some hardware problem causes an error (bits are on in the last byte of the 
message error record), send the error message to some other terminal, not to the 
terminal in error. 

Be careful when coding the FORWARD macro, since it is valid with no operands. 
If you code FORWARD PUT, no error is flagged in the assembly, since there is 
no keyword. TCAM sees PUT as a comment, and you get the default of 
DEST=**. 

If you execute the HOLD macro in the outmessage subgroup for a LOCK re- 
sponse, the LOCK is not broken, the terminal is not held, and the message is 
retransmitted immediately. This can cause an infinite loop if the condition for the 
HOLD is permanent and the line or terminal is inoperative. 

LOCK does not execute if the station that entered the message being handled is a 
buffered station. 

Use MSGEDIT to insert idle characters at the end of messages and new lines for 
terminals such as the 2740 and 1050 that can write while the type element is 
returning to a new line. 

When you code multiple groups of operands, rather than multiple MSGEDIT 
macros each with a single group of operands, data inserted in one operation is not 
considered to be part of the message segment when another operation is per- 
formed. The following summary of the MSGEDIT macro and examples are 
included in this section of the OS TCAM User's Guide as an additional aid for 
helping you to understand the MSGEDIT macro. In order to use the MSGEDIT 
macro in your program it will be necessary to refer to the OS TCAM 
Programmer's Guide and Reference Manual. 

Summary: 

1. The MSGEDIT macro allows a maximum of 3 1 groups of functions. 

2. Multiple MSGEDIT macros versus multiple function groups in one MSGED- 
IT macro is a tradeoff between speed and flexibility. 

3. Group execution is independent of coding position of the MSGEDIT macro 
but is dependent on buffer contents. 

4. All groups work on the original message contents, which means that inserted 
characters from one function cannot be the search argument for another 
group. 

5. However, inserted characters from MSGEDIT macro can be the search 
argument for a subsequent MSGEDIT macro. 

6. Data moved is all that data from the first AT= position to buffer end. 

7. MSGEDIT does not require reserved space, but allocates units automatically, 
if additional space is needed. 

8. MSGEDIT reallocates units automatically if remove functions empty units. 

9. Execution of MSGEDIT in the inheader/outheader subgroups acts only on 
one header-buffer. 

10. Execution of the MSGEDIT in the INBUF/OUTBUF acts on each buffer. 

11. Execution of MSGEDIT across buffers is not possible. 

12. The maximum length of a contiguous character string is eight which is the size 
of the AVT work area. 

The following MSGEDIT examples use a keylength of 60 and a buffer size of 120. 
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MSGEDIT-exomples 

Example 1: insert char, after s pecial char, string 

INHDR 

MSGEDIT ((^CLS'RAL'jCLS'NYC)) 



before 



after 



unit prefix 
«« 12 > 



header prefix 
30 



NYC 



NYC 



data 
-27- 



RAL 



data 
-24- 



before 



after 



unit prefix 


data 


nondata 








^ 




^ 






data 
^ o ^ 




nondata 

CI 






< ■ *„ 



Example 2: insert chars, after offset 



OUTBUF 

MSGEDIT {(\,(C0',5),95)) 



before 



after 



unit prefix 


text prefix 




data 




^ ■*• w 








^ 














data 











before 



after 



before 



after 



unit prefix 

h« 12 ► 



I 

\ 

allocated 
by MSGEDIT 

\ 



unit prefix 
< 12 



000 



data 
-60- 



data 
-58- 



\ 



nondata 
—55 



00 



2 data characters 



MSGEDIT-examples 

Example 3: insert after scan-pointer position 

OUTHDR 

MSGEDIT ((l,CL3'lll,SCAN)) 



before 
after 



unit prefix 
H 12 ► 



header prefix 
30 



data 
-20- 



data 
-20- 



scan-pointer 



nondata 



data 
«-5->- 



Ill 



± 



<4>- 



data 
t-5-> 



nondata 
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Example 4: remove characters between AT- and TO character strings 



before 



after 



before 



after 



INHDR 

MSGEDIT ((R,CONTRACT,SCAN,(10))) 



unit prefix 
-< 12 ► 



7 

/ 

MSGEDIT 

deallocates 

unit 

\ 



header prefix 
30 



unit prefix 
M 12 ► 



data 
-20- 



data 
-20- 



nondata 
— 59 



nondata 
— 60 



I 



scan pointer 



data 
— 9- 



nondata 
^ 9— 



MSGED IT-examples 

Example 5: Remove characters, including AT string 



INHDR 

MSGEDIT ((RA, CONTRACT, CLS'NYCCLS'BOS)) 



before 



after 



unit prefix 


header prefix 


NYC 


data 

.4 10 ». 


B05 




nondata 


fc- 






^ 
















B05 




nondata 











Example 6: Remove characters, including TO string 



INHDR 

MSGEDIT ((RT, CONTRACT, CL3' NYC, CL3'B05')) 



before 
after 



unit prefix 




header prefix 




NYC 


data 




B05 


nondata 












^ 














NYC 




nondata 











Example 7: Replace character string including AT/TO strings 

INHDR 

MSGEDIT ((RA^CLS'RAI^CLS'NYC'^La'BOS')) 



before 



after 



unit prefix 
^ 1° 




header prefix 


NYC 


data 


B05 


nondata 




^ 




— -^ 




^ 
















RAL 


nondata 













TCAM Problem Determination Aids 67 



MSGEDIT-examples 

Example 8: insert record delimiter characters 



OUTBUF 

MSGEDIT ((RA^ELIMI^CLl'D')) (PROCESS...., RECDEL=X'FF') 



before 



after 



unit prefix 


header prefix 




data 




n 




data 

^A 








^^ 






















data 




data 

















Example 9: multifunctions 



INHDR 

MSGEDIT ((^(A^JjRAg^ATjCONTRACT^La'NYC'jCLS'BOS')) 



^X'FF" 



before 



after 



unit prefix 
12 ». 



header prefix 
30 



data 



data 
t-5 



NYC 



data 
+ 5+ 



data 

14+ 



RAL 



B05 



data 



AAAAA 



RAL 



data 
— 7- 



data 
— 7— 



data 



before 



after 



unit prefix 


< 


lata 
-5-+ 


RAL 


data 




nondata 

At 






















At 


AAAAA 




data 






nondata 

An 
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Typical Errors 



For security in your system, use an ORIGIN macro as early as possible in your 
inheader subgroup to verify that only authorized users enter data in your system. 

When you code a macro that has the operand BLANK= and specify 
BLANK=YES to say that blanks are to be ignored, be sure that the field you are 
trying to match does not have a blank defined in it. For instance, if you define a 
character string AB as CL3'AB\ the field is automatically padded to the right with 
a blank, and a matching field can never be found if you code BLANK=YES. 

Begin with a simple message handler, and add functions one step at a time. 

Be sure to code macros in the right subgroup. 



Following is a list of common errors that can be made in coding message handlers. 
It is in the form of questions, with YES/NO answers, against which you can 
examine your code. Following this checklist is Figure 21, MH Functional Macros 
by Subgroup. 

Question 

1 . If the MH is to handle incoming messages, did you 
code the INHDR, INEND, OUTEND delimiter macros? 

2. If MH is to handle outgoing messages, did you 
code OUTEND? 

3. Does the incoming group precede the outgoing group 
if you have included both in your MH? 

4. If you coded an incoming group, did you include an 
INHDR macro first? 

5. Are inmessage and outmessage the last subgroups 
in the incoming and outgoing groups, 
respectively? 

6. If you provide a field or work area, such as for YES NO 
MSGGEN, ERRORMSG, or MSGEDIT, is the field 
addressable by the MH (is it after the OUTEND macro)? 

7. If you have more than one MH and your code includes YES NO 
literals, did you code a LTORG instruction after the 
last delimiter (OUTEND) of each MH? 

8. Is STARTMH the first instruction in every MH? YES NO 

9. Did you try to execute more than one inmessage or NO YES 
outmessage subgroup for any message? 

10. Is CANCELMG the first macro after INMSG in the YES NO 
inmessage subgroup if you use this macro? 

11. Is the CANCELMG macro in the inmessage subgroup YES NO 
only? 

12. Did you try to execute more than one CANCELMG NO YES 
macro for a message? 

13. If you plan to process headers, is the CODE macro the YES NO 
first macro in the inheader subgroup? 

14. Did you process a macro like DATETIME on an input NO YES 
segment before you issued the CODE macro or on an 
output segment after you issued CODE? 

15. If you have CODE in the incoming group of the YES NO 
message handler for an application program, did you 



Right 


Wrong 


YES 


NO 


YES 


NO 


YES 


NO 


YES 


NO 


YES 


NO 
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specify the operand NONE so that there is no 
translation? 

16. Did you issue the CODE macro more than once in an NO YES 
incoming or outgoing group for a segment? 

17. If you coded LC= IN in the ST ARTMH macro and YES NO 
plan to issue operator commands from remote terminals, 

did you move the scan pointer to the first date byte 
before issuing the CODE macro? 

18. Did you issue the CUTOFF macro more than once in NO YES 
the inbuffer subgroup? 

19. Did you provide line-control characters at the end YES NO 
of error messages you created with the ERRORMSG and 

MSGGEN macros? 

20. Did you use the MSGEDIT macro to remove the YES NO 
EOT from messages destined for a 2741 terminal? 

21. If you omitted the BLOCK= operand on the YES NO 
MSGFORM macro, did you code NTBLKSZ= or 

TBLKSZ= on the TERMINAL macro for the 
destination station? 

22. Did you issue ORIGIN in the MH for a switched YES NO 
station to identify the station to TCAM? 

23. Did you issue ORIGIN after the CODE macro? YES NO 

24. Did you try to redirect to a distribution list? NO YES 



Operating and Procedural Considerations 

This section suggests operation and procedural (JCL) techniques for running a 
TCAM system. 

If your MCP is large, you should, when assembling it, either specify a SPACE= 
parameter on your SYSPRINT DD statement, since the SYSGEN default for 
SYSOUT=A may not be large enough, or, preferably, directly allocate the output 
devices, as in 

//SYSPRINT DD UNIT=00E 
//SYSPUNCHDD UNIT=00D 

Otherwise, you may lose your assembly due to lack of space (abnormal comple- 
tion code of B37). 

Obtain an object deck from the assembly run and link it into a JOB library. You 
can then bring up your TCAM system with a procedure that executes your MCP. 
This is more efficient than running a link-and-go procedure. 

Dump SYS l.LOGREC every day as part of your regular cleanup procedure. 
Otherwise, if it gets full, it can impact your system so that you might not be able 
to execute your MCP. Also, if you let it fill up, dumping it is very time- 
consuming. If you do not want the output (because you have had no trouble with 
any of your lines or terminals), code DUMMY in the EREPPT DD statement of 
the IFCEREPO utility program. 

To save main storage after your application programs are fully tested, attach them 
(with ATTACH macros) in the MCP. Run them as separate jobs until tested, 
however, because if you do not, you will not get a dump of the programs. 
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SUBGROUP 




MACROS 


INHEADER 


CHECKPT 


MSGEDIT 


(INHDR) 


CODE 


MSGLIMIT 




COUNTER 


MSGTYPE 




DATETIME 


ORIGIN 




FORWARD 


PATH 




INITIATE 


PRIORITY 




LOCK 


SEQUENCE 




LOCOPT 


SETSCAN 




LOG 


TERRSET 
UNLOCK 


INBUFFER 


CHECKPT 


LOCOPT 


(INBUF) 


CODE 


LOG 




COUNTER 


MSGEDIT 




CUTOFF 


PATH 
TERRSET 


INMESSAGE 


CANCELMG 


HOLD 


(INMSG) 


CHECKPT 


LOG 




ERRORMSG 


MSGGEN 
REDIRECT 


OUTHEADER 


CHECKPT 


MSGLIMIT 


(OUTHDR) 


CODE 


MSGTYPE 




COUNTER 


PATH 




DATETIME 


SCREEN 




LOCOPT 


SEQUENCE 




LOG 


SETEOF 




MSGEDIT 


SETSCAN 




MSGFORM 


TERRSET 


OUTBUFFER 


CHECKPT 


LOG 


(OUTBUF) 


CODE 


MSGEDIT 




COUNTER 


PATH 




LOCOPT 


TERRSET 


OUTMESSAGE 


CHECKPT 


LOG 


(OUTMSG) 


ERRORMSG 


MSGGEN 




HOLD 


REDIRECT 



Figure 21 . MH Functional Macros by Subgroup 

As a precautionary measure, scratch all "scratch" data sets before you bring up a 
system. 

If you routinely send all output to SYSOUT=A, use a SPACE= parameter to be 
sure that the task providing a diagnostic aid or a dump does not run out of space. 

To stop a line if you have not yet responded to the message SPECIFY TCAM 
PARAMETERS, use the OS command 
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Typical Errors 



Terminal User Errors 



V lineaddress, OFFLINE 

You may list multiple line addresses by enclosing them in parentheses. After you 
have responded to the message, TCAM is in the system and you should use the 
TCAM operator command 

V lineaddress, OFFTP, [C or I] 

You must issue this command for each line you wish to stop. 

If, when you open a line, you get the message IED079I ENDING STATUS NOT 
RECEIVED addr-LINE UNAVAILABLE, do not issue a STOPLINE operator 
command on the line until you have issued a STARTLINE command. 

Be careful when closing TCAM. If you issue the command 

Z TP, FLUSH 

TCAM tries to send any outgoing messages that are queued for a station, unless 
the station is intercepted. If a terminal in your network is not intercepted, but is 
down because of hardware trouble, you will never close down because TCAM 
continually tries to flush the message queue of all messages. FLUSH is the default 
if you specify only 

Z TP 



Question Right Wrong 

1. Does the time period for CPU processing that you YES NO 
defined at system generation cover the entire time 

you plan to run continuously (coding TIME= 1440 
on the EXEC statement gives you unlimited time)? 

2. Since the DEBUG, GOTRACE, and NOTRACE YES NO 
operator commands do not allow multiple operands, 

did you issue a command for each diagnostic aid you 
want loaded and for each line for which you want the 
line I/O interrupt trace either started or stopped? 

3. For a line with hardware trouble, did you issue a NO YES 
STOPLINE operator command? (If operator control 

cannot successfully stop the line you lose operator 
control. If the command was entered from a remote 
terminal, you also lose its line, since it waits for 
the response to the command. Operator control is not 
reentrant, therefore, no other operator control 
commands will be accepted until this request is honored. 
Because of the hardware trouble, operator control 
cannot successfully stop the line.) 



When you are assessing the situation after you discover an error, consider the 
areas where a terminal user is involved as possible sources of error. Three of these 
areas are 

1. bad input, 

2. wasted processing time, and 

3. impacting the TCAM system. 

In a simple message-switching environment, the terminal user is not responsible 
for errors. You should detect any bad data entered by the terminal in your MCP 
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Typical Errors 



and cancel the message. MCP validity checking and canceling prevents bad 
messages from cluttering up your system and impacting processing time. Invalid 
data in the text is evident at the receiving terminal; its invalidity does not impact 
the TCAM system. However, in a data-collection environment, bad text data 
entered by the terminal user can cause bad output to be produced, as in reports 
and monthly statements. 

A careless terminal user can make TCAM perform unnecessary functions, thereby 
wasting processing time. Every message that a terminal enters, valid or invalid, 
passes through the message handler. To reduce processing time by reducing the 
number of invalid messages, the terminal user should know: 

• the expected format of an input message; 

• the correct spelling of all valid destination terminal names; and 

• the type of translation table used by his terminal — is the table "folded" to 
allow both uppercase and lowercase letters to be accepted as valid? 

• The terminal user should be cautioned about inserting an EOB (depressing 
EOB key) within the header since these EOBs will impact header processing. 
EOBs are not removed when LC=OUT is specified on the STARTMH macro. 

Furthermore, a terminal user at a secondary operator control terminal may 
unknowingly create a great deal of trouble, since he can reconfigure parts of the 
TCAM network without anyone knowing. If your system suddenly fails to 
operate properly for no apparent reason, first look at the terminal sheets from all 
secondary terminals to see if someone issued an operator command that impacted 
system operation. 

The major terminal user error in entering an operator command from a secondary 
terminal is failure to follow the command with a blank. Each command must be 
followed by one or more blanks before the EOT; otherwise, the command is 
invalid. A command from SYSCON may be no longer than 126 characters. 

A terminal user should do certain things to keep the system clean and running. 
First, he should keep track of his input sequence numbers to avoid wasting 
processing time if they are invalid. The input sequence number is at most four 
bytes long and must be followed with a blank. Leading zeros can be omitted. 
Second, he should examine the output sequence numbers to be sure no number is 
skipped, indicating a lost message. If a number is skipped, he should realize that 
there may be trouble on his line or terminal. Third, he should end all his messages 
with a carrier return, so that the carrier of the receiving terminal is positioned at 
the beginning of the next line for the next message. Otherwise, the carrier of the 
receiving terminal may be at the end of the line when it starts receiving the next 
message, and the message contents are lost since the message is overtyped. 
Another technique is to have a carrier return as the first character in a message. 



Question 

1. Is the input message format correct? 

2. Did the operator enter the message in the wrong 
shift? 

3. Did the operator follow an operator command 
with a blank? 

4. Are EOBs embedded in the header data? 
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Other Possible Areas of Error 



You should consider several possible sources of error that are outside TCAM. 
Following is a list of the more common sources. 

1. Control program error. You could have an error in your operating system or in 
the interface between TCAM and the system. 

2. Application program error. For example, an error in the COBOL compiler. 

3. Central hardware error. A failure, for instance, in a 2314. 

4. Remote hardware error. A failure, for instance, in a 1050 terminal in another 
city. 

5. Communications line error. 

Once you pinpoint the general area of error, you are well on your way to deter- 
mining the actual problem and how it can be corrected. 
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TCAM Diagnostic Aids 



This chapter tells you what information TCAM provides for your use in diagnos- 
ing problems, and how you can get copies of the information. The first section, 
Gathering and Interpreting Data from Dumps, covers the TCAM program and 
all the data sets that you can dump and print. This first section also suggests the 
kinds of errors that you can find, where to look for them, and, in some cases, what 
normal operations look like. The second section, Using Operator Commands, 
summarizes operator commands that you can issue to determine and alter the 
status of your TCAM system while it is running. The last section, Normal End- 
of-Day Closedown, suggests what data you might want to copy after your normal 
end-of-day closedown. 



Gathering and Interpreting Data from Dumps 



Main-Storage Dumps 



TCAM Formatted Dump 



This section tells you how to obtain main-storage and secondary-storage dumps. 
Included with each category of dumps is a detailed explanation of how to interpret 
the information. The last part of this section refers to console and terminal 
listings that you may need when you debug. 



Several types of dumps are available to you. The first, and perhaps the most 
common, is the formatted dump provided by the system ABEND routines. All 
you need to get this dump is the proper JCL as discussed below. 

However, you must be aware that eventually you will probably need a stand-alone 
dump, and you must plan for this need. For instance, when a program check 
occurs, you may lose data when the ABEND routines gain control of the system. 
Ways to obtain stand-alone dumps are also discussed. 



The job you use to bring up TCAM should include a SYSUDUMP or SYSABEND 
DD statement in the JCL for the step that executes the message control program. 
Examples are 

//SYSUDUMP DD SYSOUT=A and 
//SYSABEND DD SYSOUT=A 

This ensures that you have a data set for a dump if TCAM abnormally ends or if 
you cancel TCAM with a dump for debugging. The SYSUDUMP is of the pro- 
gram region only; the SYSABEND dump includes the OS nucleus. 

A SYSABEND dump may be too large for the default space of SYSOUT=A, thus 
you may need a SPACE= parameter. 

If you include either of the DD statements described, you can terminate TCAM 
normally (Z TP) and get no dump, or terminate it abnormally (C tcamjob,DUMP) 
and get a dump identical to the one the OS ABEND routine would produce. 

Because TCAM occupies a large region and dumping main storage may take a 
long time, you may wish to put your dump on tape and print it at a later time or on 
another machine, so that TCAM can restart as soon as possible. See the publica- 
tion, Service Aids, to learn how to transfer SYS 1. DUMP, the ABEND data set, to 
tape. 
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Example: 

//TRNSDUMP JOB MSGLEVEL=( 1 , 1 
//* TO PUT SYS 1. DUMP ON TO TAPE 



// 


EXEC 


PGM=IMDPRDMP 




//SYSPRINT 


DD 


SYSOUT=A 




//PRINTER 


DD 


SYSOUT=A 




//TAPE 


DD 


DSNAME=SYS1 . DUMP ,DISP=OLD 




//SYSUT2 


DD 


UNIT=2400 , VOL=SER=DUMP , LABEL=( 


,NL),* 


// 




DISP=NEW 




//SYSIN 


DD 


* 




END 








/* 









A TCAM dump contains a great deal of information, only part of which you can 
use for any particular problem. The information you use varies according to the 
nature of the problem, and may be different for each problem. You must decide 
what to look for. Therefore, you should examine the coding of your message 
control program (MCP) and determine as much of the problem as possible before 
looking at the dump. You must know what events led up to the problem and the 
general nature of the problem; if you do not, you will be hopelessly lost in the 
dump. 

This section shows some of the major items in a TCAM formatted dump, as well 
as possible starting points in TCAM debugging. For a complete description of the 
fields in a TCAM formatted dump, see Appendix C. Formatted TCAM Dump. 
For a description of the fields in an OS formatted dump, see the Guide to Read- 
ing Dumps. 

Reading the Dump: A formatted TCAM dump is produced as part of the OS 
formatted dump when TCAM resides in the system. The TCAM part of an MFT 
dump starts after the trace-table entries; the TCAM part of an MVT dump starts 
after the save area trace. The following 14 parts of Figure 22 illustrate the items 
of a TCAM dump. 

The first item printed in the TCAM dump is 

TCAM ADDRESS VECTOR TABLE hhhhhh 

where hhhhhh is the starting address, in hexadecimal format, of the TCAM 
address vector table (AVT). The AVT is the major control block of the TCAM 
system, and begins eight bytes beyond the start of the INTRO macro. 

Next are five save areas, with their offsets from the start of the AVT printed in 
the left-most column of the dump. The save areas are shown in Figure 22 Part 1. 

Table Pointers: The table pointers (Figure 22, Part 2), with their offsets from the 
start of the AVT printed in the left-most column of the dump, include: 

1st word (at offset X'148') — last three bytes is a pointer to (address of) 

the device characteristics table 

11th word (at offset X' 170') — last three bytes is pointer to the TCAM 

MCPtask control block (TCB) 

12th word (at offset X'174') — last three bytes is a pointer to the TCAM 

line I/O interrupt trace table if you includ- 
ed this table in your system. 
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TCAM ADDRESS VECTOR TABLE 029970 

SAVE AREA 1 USER REGISTERS 

0000 OCOCOCOC C00777B0 0C0399B8 5003A6C4 
C020 5C0198C8 C00158C8 C00157A0 0001962C 
0040 OCOCOCCC 4007EC8A 

SAVE AREA 2 DISPATCHER 

0048 BC04C38A 0000016C 

0060 80C68C6A 00042902 0C06D818 02C69280 
0080 8CCC0CCC 0003A9B8 00068BC0 0003B370 



00068BC0 OOOOCOOO 000399B8 40039EA4 
00015860 000198B0 C0019B88 000198D8 



B003F2CC 00068BC0 0004233A 00C399B8 
0006B8B0 E406E66C 1203B35C 0OC0OCO4 



SAVE AREA 3 1ST SUBROUTINE CALLED BY DISPATCHER 

0090 4C03DA88 

OOAO OOCOOOOO 40046620 0C07DA70 00039AC8 0006D818 
OOCO 12039910 C0000004 OC039970 00000001 C000006A 

SAVE AREA 4 2ND SUBROUTINE CALLED BY DISPATCHER 



00067BCA 8303AD58 FF047622 
03069280 0006DB40 E406E660 
00047288 



00D8 
00 EO 
0100 



0C03ASB8 600684CC 0C03E8B8 OOCOOOOO 
OC000027 0206DBE0 1903D2EC 0003AEEC 



00000001 00000000 
00039AC8 000692A0 C00692A0 E0069280 
00000025 0103A9B8 00000054 00068428 



DISABLED SAVE JREA USED BY SVC 102 AND APPENDAGES 

EF03A98C 00001000 00000018 000014A0 



0120 
0140 



OO00C17C 00002BDC 0C06A0F8 1B016B14 
0C0C0938 00000000 



Figure 22. A Formatted ABEND Dump Printout (Part 1 of 14) 



TABLE POINTERS 



DEVICE 

CHARACTERISTICS 
TABLE ADDRESS 



0148 
0160 



0( |03E248| 5000084C 
D607C9C4 40404040 4C404040 40404040 



8 0065BB4 003B1FB 02A800A0 0006AB20 
q019D18| 0J069370~| 
ADDRESS OF ADDRESS OF 
MCP'S TCB TCAM LINE I/O 

INTERRUPT 
TRACE TABLE 



Figure 22. A Formatted ABEND Dump Printout (Part 2 of 14) 

Dispatcher Ready Queues: Following the table pointers are the dispatcher ready queues. 
These are shown with their offsets in the left-most column of Figure 22, part 3. They include: 



1st word (at offset X' 178') 



•pointer to the enabled ready queue (first 
element to be dispatched) 



12th word (at offset X'1A4') — pointer to the TCAM dispatcher subtask 

trace table if you included this table in your 
system. 

13th word (at offset X'1A8') — pointer to the terminal name table. 



DISPATCHER REACY QUEUES 

0178 

0180 0CC6ACC8 0077348 OC 048A60 D2273054 

01A0 02039AC8 C QJ06B8B0 I 0C P3CDC0 I 0003A698 

01C0 000777F8 140000C8 0C04839C 



ADDRESS OF 
TCAM DISPATCHER 
SUBTASK TRACE 
TABLE 



ADDRESS OF 

TERMNAME 

TABLE 



ADDRESS OF 
ENABLED 
READY QUEUE 



0C (039C2C| OOCOOOOO 
C01CD227 D01C305-4 2800282C 00039970 
00066CAA 00039D88 00039CC4 00039CC4 



Figure 22. A Formatted ABEND Dump Printout (Part 3 of 14) 
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TCB Pointers: Next are the TCB pointers to four TCAM TCBs, with their offsets 
in the left-most column. See Figure 22, Part 4. 

ECBs: Figure 22, Part 5 contains the addresses of some internal routines and 
event control blocks (ECBs); their offsets from the start of the AVT are printed 
in the left-most column of the dump. 

The first four words are ECB pointers; the remainder are pointers to TCAM 
internal routines and subtasks. The tenth word (at offset X'200') is a pointer to 
the cross-reference table if you included this table in your system. 

Special Elements: Figure 22, Part 6 contains, at an offset of X'2D0' (5th word of 
the last line), the address of the current buffer. At an offset of X'2D8' is the 
address of the VCON table. Offsets from the start of the AVT are printed in the 
left-most column. 

QCB Pointers: A list of queue control block (QCB) pointers, with offsets in the 
left-most column is shown in Figure 22, Part 7. At an offset of X'384' is the 
address of the start of the buffer-unit pool. The third word on the last line (at 
offset X'388') contains the number of buffer units being used by main-storage 
queues. 

Interface: Figure 22, Part 8 contains parameter lists, interface work areas, and 
constants; offsets are printed in the left-most column of the dump. The third 
word of the last line (at offset X'408') contains, in the first two bytes, the key 
length of the message queues, and, in the last two bytes, the number of lines 
opened. At an offset of X'410', the first two bytes are the number of free units in 
the buffer-unit pool. 



TCB POINTERS 
01CC 





OPERATOR 








CONTROL 


ON-LINE 


FE COMMON 


CHECKPOINT 


TCB 


TEST TCB 


WRITE TCB 


TCB ADDRESS 


ADDRESS 


ADDRESS 


ADDRESS 


00016650 


00017098 


00019218 


000190C8 



Figure 22. A Formatted ABEND Dump Printout (Part 4 of 14) 



ECBS 

01DC 
01 E0 
02 CO 

0220 
02 40 



ADDRESS OF 

CROSS-REFERENCE 

TABLE 



C C000C0C 
0d077668 



C00000C0 00000000 80019B50 
00019828 000422B8 000422A8 



0C041C28 00068BC0 00068E3A 00067B5A 
0CO6549O 00000000 OC0OO00O 



00000C00 
0003 A7E8 0003CFCC O0042A0E 00000000 
0A041FFE 00041D08 00042612 00C47C78 

00063F32 0004D1E8 00077868 0C03E91A 



Figure 22. A Formatted ABEND Dump Printout (Part 5 of 14) 



SPECIAL ELEMENTS 



024C 00000000 

0260 OOOOOOCO 00000000 00000510 47F01266 

0280 0C068€60 OOOOOOCO 0C042048 20039CD0 

02A0 EC039C2C 7C039C94 8C02012C 62550800 

02C0 OC039C2C 4C039CAC ECC39C2C 0000FFFF 



00000000 00000000 00000000 OOOOOCOO 
00000000 00000000 00000000 OOOOOCOO 
F000000C 00039C0C 00039C94 70039C5C 
00000802 0004 IF 84 8039C5C O0039AEO 
E 406E66C | 00000000 80 |03E280| 



ADDRESS OF 

CURRENT 

BUFFER 

Figure 22. A Formatted ABEND Dump Printout (Part 6 of 14) 



ADDRESS OF 
VCON TABLE 
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Core Queue: Figure 22, Part 9 shows this section, with offsets from the start of 
the AVT printed in the left-most column. See Appendix C for a description of 
each field. 

Disk: This section contains the queue and control information for the disk 
message queues. Figure 22, Part 10 shows this information, with the offsets into 
the AVT printed in the left-most column. 

At an offset of X'46C is the address of the CPB free pool. The first word of the 
fourth line (at offset X'480') is a pointer to the reusable disk data extent block 
(DEB). The seventh word of the fourth line (at offset X'498') is a pointer to the 
nonreusable disk DEB. 

Termname Table: TNT 03CDC0 is the address, in hexadecimal format, of the 
TCAM terminal name table, which contains the names and addresses of all the 
terminal-table entries. Figure 22, Part 1 1 illustrates this section. See Appendix C 
for a description of each entry. 



QCB PGINTEPS 










020C 










OCOOOCOO 


02E0 


00068418 CO00000C 0C0445F8 00039C5C 


F0039C2C 


00041068 


000074E6 


E1720100 


0300 


0C039C5C C0039C5C OC039C0C 0806DA00 


00000000 


00042338 


02039C2C 


00000000 


0320 


0C0424F6 C2039C2C 8CC16C20 00039C94 


02039C2C 


80019658 


00039CAO 


02C39C2C 


0340 


80019E30 00039CAC 2039C2C 00000000 


00042900 


C2039CC4 


00000000 


00043408 


0360 


02039CCO C0000000 00041F98 02039C2C 


00000000 


0003FFB0 


02039CE8 


00039C2C 


03 80 


0CC40526 CC(060AOO||OC000007| 00000000 

ADDRESS OF NUMBER OF BUFFER 
START OF UNITS USED BY 
BUFFER-UNIT MAIN- STORAGE 
POOL QUEUES 











Figure 22. A Formatted ABEND Dump Printout (Part 7 of 14) 



INTERFACE 

0390 
03A0 
03C0 
03E0 
04C0 



OC04EF58 
CC000CCC 
OCCCCCCC 
00030CC4 



60019AF8 FFC4D9E4 FF04886E 
OOOOOOCO OC000O0O 00C0CC00 
CC0O00C0 0C00C000 00000000 
C0070010 ICC54Jr0C6J 00000000 



SIZE OF 
BUFFER UNIT 
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LINES OPENEO 
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FF04E654 0000C000 00000000 OOOOOCOO 
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00000000 0000013C 00039AC8 20000C02 
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UNITS IN BUFFER- 
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Figure 22. A Formatted ABEND Dump Printout (Part 8 of 14) 

CORE CUEUE 

0420 0C03F654 CC000064 OC0CCC8C 000000C8 040C00CC 0006A124 

Figure 22. A Formatted ABEND Dump Printout (Part 9 of 14) 
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04C0 
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0C J019710 



OCO00C15 
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Figure 22. A Formatted ABEND Dump Printout (Part 10 of 14) 
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Terminal Table: Following the terminal name table are the terminal-table entries. 
They are listed in alphabetical order with one entry for each terminal. The format 
of an entry is shown in Figure 22, Part 12. 

NAME AA 
TRM 03AFD4 

where AA is the name of the terminal and 03AFD4 is the hexadecimal address of 
the terminal-table entry. 

The last three bytes of the field STATE/DESTQ are a pointer to the QCB for this 
terminal. The field IN/OUTSEQ contains the next expected sequence numbers, 
input and output, for this terminal. 

A sequence number of 0001 means that the first message is the next message 
expected. 

TCAM Destination QCBs: Following this heading are entries for all destination 
QCBs for the terminal-table entries. There is one set of entries for each QCB. 
Depending on the type of queuing used, one QCB may service several terminals. 
See Figure 22, Part 13 for the format of the QCBs. 

The last three bytes of the field RELLN/DCBAD contain a pointer to the data 
control block (DCB). The first byte is the relative line number for this QCB. The 
last two bytes of the field INTVL/MSGCT contains a count of the number of 
messages on this queue. 

TCAM DCBs: This section includes the three different types of TCAM 
DCB — the line group DCBs with their related line control block (LCB), the 
checkpoint DCB, and the message queues DCBs. The DCBs are illustrated in 
Figure 22, Part 14. 
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TERMNAME TABLE 



TNT |03CDCC| CCCE 1801891C 00031A10 

00084301 F0508900 

SPCHX 0010 EM.EN 08 ^ 

CCCDE 18898990 00031A98 
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1B00A301 
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LEN 
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1B884389 


704F8980 


C008A389 




705107F6 





Figure 22. A Formatted ABEND Dump Printout (Part 1 1 of 14) 



ADDRESS 
OF 0CB 



NAME A A ' •■" I 

TRM C3AFD4 STATE/DESTQ 1 8ft3D550| IN/0UTSEC OOoJoOOl ALTD/DEVFL 00006400 STAT 00000000 CHCIN 



CIAL CIGITS 
ACCR CHAR 
TRANS BLOCK 



03020006 
02276126 
0090 



NEXT EXPECTED 

SEQUENCE 

NUMBER 



Figure 22. A Formatted ABEND Dump Printout (Part 12 of 14) 



TCAM DEST^ATICh QCfi'S 



QCB 03D00C CSFLG/ELCHN A20C0OOO PRI/LINK 00000000 STVTO/STCHN 1003 0008 STPRI/SLINK 5003EBA8 

ECL0T/STAT 00000000 SCBOF/INSRC 00030000 INTVL/MSGCT Q00 0|00C0| PRLVL/LKRRN 0C03A0F0 

RELLN/DCBAD CJ03A84C| FLAG/QBACK 02000000 MESSAGE 

DCB COUNT 

ADDRESS ON THIS 

QUEUE 

Figure 22. A Formatted ABEND Dump Printout (Part 13 of 14) 
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DCB 03A9B8 (LINE GROUP) is the starting address, in hexadecimal format, of 
this line group DCB. 

On the line D/S INTERFACE, the last three bytes of the first word contain a 
pointer to the message handler. The last three bytes of the third word are a 
pointer to the input/output block (IOB) base. The last three bytes of the fourth 
word are a pointer to the translate table. The first byte of the fifth word is the 
IOB index. 

On the line FOUNDATION, the first two bytes of the first word are the offset of 
the DD entry from the beginning of the task I/O trace (TIOT) table. The last 
three bytes of the second word are a pointer to the DEB. 

LCB 069280 is the starting address, in hexadecimal format, of the LCB. 

The third byte of the field FLAGS/SENSE is the last (fifth) byte of the message 
error record. The last three bytes of the field UCBX/RCBFR are a pointer to 
either the recalled buffer or the last buffer serviced by the buffer allocation (PCI) 
routines. The last two bytes of the field ERBCT/TTCIN are the index into the 
terminal name table of the terminal currently connected to this LCB. The last 
three bytes of the field MSGFM/SCBA are a pointer to the current station 
control block (SCB). 

See Appendix C for a complete description of the three types of TCAM DCBs 
and the line group LCB. 

Using the Dump: If you cannot find your problem by examining your code, one of 
the first things that you should do with the dump is identify the TCAM QCBs, 
DCBs, and LCBs by terminal. This can save you a lot of page turning. 

First locate the terminal table in your formatted dump (see Figure 22, Part 12). 
The last three bytes of the first entry (STATE/DESTQ xxhhhhhh) are the address 
of the QCB for this terminal. Go through the terminal table; find and mark the 
QCB for each terminal with the name of the terminal. 

Then go to the first QCB entry under TCAM destination QCBs. The last three 
bytes of the field RELLN/DCBAD are the address of the DCB. For each QCB, 
find the DCB pointed to by this address and mark the DCB with the name of the 
terminal. The field ERBCT/TTCIN in the LCB for the DCB may be useful if you 
have more than one terminal on a line. The last two bytes of the field are the 
offset into the terminal name table of the terminal currently connected on this 
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ERMSK/INVPT 0003B208 
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RECALLED BUFFER 
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BUFFER SERVICED 



PRI/LINK E0039C2C 
CHAIN/INSRC 10000000 
ECBCC/ECBPT 7F039BE0 
DCBPT 0003A9B8 
RECOF/STATE 00000102 
ER8ST/ER8CH 41000000 
TPCD 53001111 
0C400002 
00039970 



RSKEY/STCBA 1803C338 
SCBO/SCBOA 00000000 
FLAG3/CSM 00000000 
RCQCB 0404FB90 
TSTSW/RECAD FO0 O0O00 
ERBCT/TTCIN OlO tfOOOT 

0S010905 
ERCCW 29580001 

0C060B18 



RSPRI/RSLNK 20068F94 

ISZE/FSBFR 04000000 

00000000 

INCAM/ERPCT 00000000 

ERBKY/ERBOB 0039CB8 

MSGFM/SCBA 0060818 

000000AA 

600658EA 

00000814 



Figure 22. A Formatted ABEND Dump Printout (Part 14 of 14) 
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line. The field may be zero, indicating a dial line with no terminal connected at 
this time. Otherwise, the field gives the offset into the terminal name table of the 
single terminal connected to this line. 

At this time, you can find the associated DEB and DD entry for each DCB, in 
case you should need it for further debugging. 

In the DCB, the second word of the line FOUNDATION is a pointer to the DEB. 
The first two bytes of the first word of this line are the TIOT offset. 

To find the DD entry from the TIOT offset in the DCB, use the following steps 
(see Figure 23): 

1. Convert the TIOT offset from hexadecimal to decimal. 

2. Subtract the total length of jobname+stepname+procname. This length is 
always 24 bytes. 

404 

24 

380 

3. From the formatted portion of the OS dump, under the TIOT, the line labeled 
DD is a DD entry in the TIOT. The first byte on this line is the length of the 
DD entry. Divide the total from step 2 by this length. 

X'14' = Decimal 20 

380/20=19 
Therefore, the DCB is associated with the 19th DD entry (starting with 0). 

Now that you have found and identified all your QCBs, DCBs, LCBs, DEBs, and 
DD entries, you can begin to look for your problem. 

Find the current buffer. AVT+X'2D0' is a pointer to the current buffer. 

The current buffer, at an offset of X'OC, gives the address of the LCB for this 
message, at an offset of X'10', the terminal-name table offset of the source 
terminal, and, at an offset of X'28' (if this is the first unit), the terminal-name 
table offset of the destination terminal. You now know which message was being 
processed when the problem occurred. You also know where the LCB is, which 
terminal was sending, and which terminal was receiving. The source and destina- 
tion offset fields may not be filled in. These fields are updated upon execution of 
certain message handler macros. However, the LCB is correct and always present 
in the prefix. 

Find the LCB pointed to by the buffer prefix, and, in the LCB, find the SCB 
address at an offset of X'5C. The SCB address is the last three bytes of the entry 
MSGFM/SCBA. 



DCB 03A908 



(LINE GROUP) 
DEVICE INTERFACE 
D/S INTERFACE 
FCLNCATI0N 
EXTENSION 
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000177E4 
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DECIMAL 









Figure 23. Finding a DD Entry from the DCB (Part 1 of 2) 
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Locate the SCB in the unformatted section of the dump. The fifth word (at offset 
X'10') in the SCB is the first four bytes of the message error record. The last byte 
of the message error record is in the LCB at the third byte of the entry 
FLAGS/SENSE. Examine the message error record thoroughly, as it contains all 
the status information about the current (or last) message. 

The last message, and thus the message error record, for each line can be exam- 
ined in the same manner as the current message. The address of the last buffer 
processed by each line is in the LCB at the entry UCBX/RCBFR. 

If your system fails when transmitting a message, find the message-handler macro 
routine that is the next, current, or last macro executed on the current buffer. 
This helps you determine what the system was doing when it failed. 

First, find the current buffer at AVT+X'2D0'. Add X'OC to the address found at 
this location to obtain the LCB address. Add X'5C to the LCB address to obtain 
the SCB address. 

The second word of the SCB points to the parameter list of the message handler 
macro that is the next, current, or last macro executed on the buffer. The macro is 
usually an inmessage or outmessage macro. However, if you have a multiple- 
buffer header, the parameter list is for an inheader or outheader macro. Go to the 
parameter list. The first byte is an index into the VCON table for the message 
handler macro routine involved. A pointer to the VCON table is found at 
AVT+X'2D8\ 

If the first two bytes of the parameter list contain X'0100', inmessage or outmes- 
sage processing is either complete or has yet to begin, or you had a single-buffer 
header when performing inheader or outheader processing. 

From your code, from the information gathered at the system console, from 
terminal listings, from the operator's description of what happened, from the 
message error record, from the buffer prefix, and from the various trace tables if 
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Figure 23. Finding a DD Entry from the DCB (Part 2 of 2) 
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Stand-Alone Dump 



you specified them, you must decide what the problem is-or what to look for next. 
From this point on, only experience can tell you what to do. 



To prevent losing data in the OS ABEND routine, and to see the complete status 
of the system at the time of a program check, you may set the wait bit on in the 
program new PSW and recreate the condition that caused the program check. 
When the system enters a wait state, the program check has occurred, and a 
stand-alone dump revealing the entire system status at the moment of the failure 
can be obtained. For non-program check problems (system ABEND), you can 
obtain a stand-alone dump revealing the entire system status at the moment of 
failure by placing an address compare stop at the entry to ABTERM. 

Use the OS service aid programs to create a stand-alone dump. You should 
assemble and link-edit the dump (IMDSADMP) service aid before problems are 
encountered. The time you spend to assemble one of these programs and to add it 
to your system is time well spent. OS service aid dumps are: 

1. Low-speed dump. This dumps main storage directly to the printer. It is an 
unformatted dump, printed in hexadecimal, 4 bytes to the word, 8 words to the 
line. The main-storage address is printed at the left-most column of the dump, 
and the character equivalent of the 8 words at the right-most column. The first 
two lines on the first page of the dump are the general-purpose register con- 
tents. Figure 24 illustrates the start of a printout from a low-speed stand-alone 
dump. 

2. High-speed dump. This dumps main storage to a magnetic tape that can be 
printed and formatted at a later time using another service aid program. This 
printout can be made on the same or some other system. 

Several options are provided by the service aid programs. These are discussed in 
IBM System/ 360 Operating System: Service Aids, GC28-67 19, in the section 
IMDPRDMP. 

You can use, the following JCL to assemble the low-speed dump. 

//SLOWDUMP' JOB MSGLEVEL=( 1,1) 

//STEP1 EXEC ASMFC 

//ASM.SYSLIB DD DSN=SYS1 . MACLIB, DISP=SHR 

//ASM.SYSIN DD * 

IMDSADMP IPL=191 , CPU=360 , PROTECT=NO, TYPE=LO , OUTPUT=P00E 
END 



R" 0-7" 00000000 G000000O 00000000 00000000 00333000 00333000 00000000 30000000 

-A-S^-l-5 00000000-00003 COO 000 04003 000330 30 — : — 003000 003 00 3 3C 

8000 00000191 000O1C00 00000000 60000028 083000 8 4 0030001 FF0603 83 -&60O66OO — 

300320 FFF50001 50072D1A 00000003 00003000 O333FFO0 00330300 FF063313 8C00C300 *.5, 



— 30034Q F006A348-00400CQ4—F006 4330 00007708 — 03£-*2«00-OGOOB;D& -00040360- 0030*1 6S— *0» .-». ..0. 1I r l T l .}i > .i T r.m T n^ 

300060 00C40000 000097D8 03040003~0030920E 00330000 30312CC0 00040303 3030926A * Q * 

OOOOAC C0000000 00000000 00000403 00000000 00333000 000300C0. 03000303 30030000 * * 

— 3O0OC0 COOO O OOO -00000600-00030603 66306033 — — - 03300000- 30330600 -30900333 -36-300000 *...-».»....*.... ^ . ... . .-.-**-- 

— 3©6tfr0 — — - OOOGGOOO -0000Q0OC-O000000O--8200OW0 033*OOGO-6033«9£6-06063363-0600G003 — *w .-.,-. ...... » .. . . . »-.-.. .)rr. *■*■•■***■- 

300183 FF060018 80000000 0003318A 018A31BA FF303190 33330190 03000301 30334B64 *. • 

— 30OtA0 — 00O67OGO -G003AC-3-4- 000346 3V-6O366S&0 0O36A-26a-0OO34A€-8-0660 03 33 -13334938 *^» ., ........ . . ., . .... . .1 -. . . . . .-. .*- 

30C1C0 .00000000 00072B88 0003CFAA 000349C0 80072D0C 3033D572 00000303 3COOC0C0 * • N * 

— 3001E3 00000000 O0000C00 OOC30003 00000000 03330000 00030000 00003303 -36-300000- -^rrrrrTTnriTTTn . irrmmimi*- 

Figure 24. Start of a Printout from a Low-Speed Stand-Alone Dump 
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You can use the following JCL to assemble the high-speed dump. 

//FASTDUMP JOB MSGLEVEL=( 1,1) 

//STEP1 EXEC ASMFC 

//ASM.SYSLIB DD DSN=SYS1 .MACLIB , DISP=SHR 

//ASM.SYSIN DD * 

IMDSADMP IPL=1 90 , CPU=360 , PROTECT=NO , TYPE=HI , 

OUTPUT=T283 
END 
/* 
The following JCL prints the dump tape. 

//DUMPPRT JOB MSGLEVEL=( 1,1) 

// EXEC PGM=IMDPRDMP 

//SYSPRINT DD SYSOUT=A 

//PRINTER DD SYSOUT=A, SPACE=( 1 2 1 , ( 8000 , 1 00 ) ) 

//TAPE DD UNIT=2400,VOL=SER=DPTAPE,LABEL=( , NL) , * 

// DISP=OLD 

//SYSUT1 DD UNIT=SYSDA,DISP=( NEW, DELETE),* 

// SPACE=( 2052, (257, 10) ) 

//SYSIN DD * 

GO 

END 
/* 

Note: The SPACE= parameter shown in the sample JCL may not reserve 
enough space if you select all the options. 

Once you know how to locate the address vector table (AVT) and a line control 
block (LCB) in this type of dump, using a stand-alone dump is similar to using a 
formatted dump. This section shows how to locate these and other important 
control blocks, and gives some examples using a stand-alone dump. 

Finding the AVT: To find the AVT in a stand-alone dump, get the address of the 
communications vector table (CVT) from absolute location X'10\ X'10' may not 
contain this address, because the stand-alone dump program may destroy it. If 
this is the case, find the CVT address at absolute location X'4C. 

Add X'FO' to the address of the CVT. The address at this location is a pointer to 
the address of the AVT, which starts eight bytes beyond the beginning of the 
INTRO macro. 

Example: 

The contents of the word at location X'4C is X'D548'. 

D548 CVT address 

F0 Offset into the CVT 

D638 Pointer to the AVT address 

The last three bytes at location XTJ638' is 019A08, which is the pointer to the 
AVT address. The last three bytes at location 019A08 is 023170, the address of 
the AVT. 

Finding the Current Buffer: AVT+X'2D0' contains a full word pointer to the 
current buffer. 

Finding the Line I/O Interrupt Trace Table: AVT+X'174' contains a fullword 
pointer to the control block for the line I/O interrupt trace table. The control 
block contains: 
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OOD500 0GC10CC0 40000000 O0O12BF8 00012BA4 00018658 80000000 00000000 OOOOOCOO * 8 * 

00D520 SOCOOOOO OOQ^nnnn 00000000 00000000 00000000 00000000 00000000 00000000 * * 

00D540 OCCC0C5C F2*™RT [0C009E0C 00009494 0000D4DC 00011928 00000000 OOCOOECC *...£200 M * 

0OD56O 0C009C26 CO?;.SYI 0000795C 0000109E 000010C6 00009858 00002950 O0COFD4C * * F £...<* 

000580 0C71292F C00119C0 OG007A68 00011A88 00012C68 00000000 0A0307FE 000004E0 * .....M.* 

00D5A0 00011AC8 000075F4 OOOOOCOO 000104C0 00010984 0001064C 000037C0 10011794 *...Q...4 < ..* 

0005CO 00002EAC C0000E78 0C01A000 0001CC3E 00009574 00001086 0000018A 000119C0 * * 

0005E0 00004526 COOOOOOO OOOOAAIO 0007FFFF OOOCOOOO 00000000 00011BD8 0000400C * Q.. .* 

00D60C 00006266 C000D510 OCCOOOOO 00017B60 0000510C 00000000 0000000 pnnSfgB to * N ~ * 

000620 000CD518 00011BE8 OOOOOCOO 00000000 00000000 00000000 80gT9A08j ^VT 'ADDRESS** ,N * •• ,Y * 

00D640 OCCCOCOO CC009C54 OCOOOOOO OOOOOCOO OOOCOOOO 00000000 50B0A128 45AUAi;t/ * £ S* 

00D660 D207COOO C0209620 CC0241A0 ACBE47F0 A00A50B0 A10E45A0 A0C8D207 C0000038 *K 0..G HK * 



0199C0 404C4C40 40404d40 4C404040 40404040 

0199EC 0B019AE8 C0019B18 C 9C5C4D8 E6C14040 

019A00 C00193E0 00000028 0C |023170| 00000000 

019A2C CCOOOCCO COOOOOOO 0»ADDRESSOOOOOOOO 

019A4C 000538C0 C0001800 <0F AVT JC019A38 

019A6C 000570CC C0009800 CSC5C4D8 C3C14040 

019A80 OOOCOOCO 000166E0 0032000 00019660 



00C00050 COOOOOOO 000199F8 01019108 
01032C90 20019670 00019D48 02019200 
000196A8 9000BC62 00000000 OOOOOCOO 
00052800 00001000 00053800 00019A28 
00055000 00002000 00057000 00019A48 
00040082 00019930 FFE50C68 40C32394 
00032000 00000800 00000010 00C00C01 



*...Y.. 



...& 8...Q* 

.IEDQWA ...* 



* IEDQCA 



023140 
023160 
023180 
0231AO 
0231C0 



DFDF03CF C^VVy- 01400513 13131313 
E7E2CAE7 E op u Cp [4 7F0F502 03E3C1D4 
CC0525A8 Ooiuuuuu 0C0231B8 400236A4 
0C01586C C0019578 000195E0 000195A0 
CC0C0C54 000525A8 0C02BB3A 000231B8 



START OF AVT 616013D 011F0C13 13131313 
[00000000 00060FB0 000231B8 50023EC4 
5C0195A0 000158C8 000157A0 00017144 
COOOOOOO 4007EC8A B0029B8A OOCOOCOO 
80052772 0002C102 400273FC 01060880 



♦ XS.X.F...05..TAM CD* 

*............ ...*... ...H. ...♦...* 

*...- * 

* A * 



Figure 25. Finding the AVT in a Stand-Alone Dump 

offset +0 address of the current entry 

offset +4 address of the first entry 

offset +8 address of the last entry 

offset +12 address of the middle entry 

Finding the Subtask Trace Table: AVT+X'1A4' contains a fullword pointer to the 
control block for the subtask trace table. The control block contains: 

offset +0 address of the next entry 

offset +4 address of the first entry 

offset +8 address of the last entry 

offset +12 size of the table 

Finding the Cross-Reference Table: AVT+X'200' contains a fullword pointer to 
the control block for the cross-reference table. The control block contains: 

offset +0 address of the first available entry 

offset +4 address of the last entry 

Finding the QCB for a Terminal: AVT+X'1A8' is a pointer to the terminal name 
table. At the terminal name table + X'52' the entries for each terminal start. 
Each entry includes the name of the terminal (a maximum of eight bytes) followed 
by the address of the terminal entry (always three bytes). The first word of each 
terminal entry contains a pointer to its QCB. 

Finding the DCB: QCB+X'20' contains a three-byte pointer to the DCB. The 

first byte is the relative line number. 

Finding the LCB: There are four different ways to find an LCB. You can find the 
LCB for an open line in the third word of the cross-reference table entry. Each of 
the other three ways is discussed below. 



86 OS TCAM User's Guide 



IOB base 




45848 


IOB index 


+ 


DO 


X'20' 


- 


20 



From the DCB: If the DCB is opened, DCB+X'IC contains the three-byte IOB 
base address. Find the one-byte IOB index (DCB + X'24'), multiply this value by 
the relative line number of the line you are interested in (QCB+X'20'), and add 
the result to the IOB base address, then subtract X'20'. 

The following example uses a fictitious base and index just for the purpose of 
illustration. 



RLN=1 



LCB address at 458F8 

LCB address= [IOB base + (RLN * IOB index)] - 20 

From the Buffer: The buffer prefix contains the three-byte LCB address at the 
offset X'OD'. 

From the Terminal Entry: First, locate the terminal name table. Its address is in 
the AVT at an offset of X'1A8\ The actual table entries begin at X'52' into the 
table. See Figure 26. 

The format of a terminal-name table entry is 



NAME FIELD 


TERMINAL-TABLE 
ENTRY ADDRESS 



where the name field is a maximum of eight bytes (the length is the value specified 
in the MAXLEN= operand of the TTABLE macro), and the terminal-table entry 
address is a three-byte field. 

Decide which terminal you are interested in, and locate its terminal-name table 
entry and the address of the terminal entry. 

The last three bytes of the first word in the terminal entry are the address of the 
QCB. At X'20' beyond the start of the QCB is the relative line number of the line 
(first byte) and the address of the DCB (last 3 bytes). 

Add X'lC to the address of the DCB (address present only if DCB is open). The 
word at this location is the base address of the IOB. Add the base address of the 
IOB to the product of the contents of the byte at DCB+X'24' and the relative line 
number. Subtract X'20' from this sum. The result is the LCB address for the 
terminal you are interested in. 

Example: 

023170 starting address of the AVT 

1A8 offset to address of terminal name table 

023318 address of the terminal name table 

The last three bytes of the word at location 023318 contain the address of the 
terminal name table. Go to the terminal name table at location 0265C0. 
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023260 


000232C8 


00057148 


023280 


0C000C25 


C10241B8 


0232AC 


EF02418C 


00001000 


0232C0 


8C04F3B4 


C2000037 


0232E0 


CC0196A8 


00052B70 


02330C 


DC1C0227 


D01C3054 


023320 


CC0504AA 


C0023588 


023340 


000166EO 


00016A78 


023360 


00023FE8 


000267CO 



00057148 E0057128 
OC000054 00051C28 
00000018 OC0014AO 
02000000 00057F20 
0C02342C OOOOCOOO 
OC0150C4 00023170 
CC0234C4 000234C4 
00000000 40000000 
0002C20E OOOOOCOO 



00000027 020573E0 19026AEC 000246EC 
00000191 00002750 00000938 4000084C 
0C0C0938 OOOOOOOC 00027A48 50C0084C 
06D7C9C4 40404040 40404040 40404C40 
000234E8 00000000 0032260 D2273C54 
20026579 000550BO 0|0265C0| 00023E98 
00060FF8 140000C8 ADDRESS OFOCOOCOO 
40000000 OOOOOOOC TERMNAME 0019B48 
00060EB8 00019188 TABLE 002BAA8 



*...H * 

* £.... ..<* 

* £..<* 

*..3 OPID * 

* Y -K...* 

*..K £0 £ * 

* D...D...8...H * 

*............ ... .............. .* 

*...Y B * 



Figure 26. Finding the LCB in a Stand-Alone Dump (Part 1 of 6) 



0265C0 

52 

26612 



address of the terminal name table 

length of the control area 

beginning of terminal-name table entries 



Assume you want to find the LCB for a terminal named NYC. You can find its 
entry in either of two ways. The simplest is to glance down the converted portion 
of the dump printed in the right-most column and find the characters NYC. 

The other method uses the control area of the terminal name table. At an offset 
of X'28' into the table, a one-byte field gives the length of the name field. Add 
three to this length to find the length of an entry. Multiply this sum by the 
number of entries that alphabetically precede the terminal you are interested in. 
Be sure to count the names of the TPROCESS, TLIST, and LOGTYPE macros as 
entries. 



0265C0 

28 



terminal-name table address 

offset to the length of the name field 

address of the byte containing the length of the name 

length of a terminal-name table entry. 



0265E8 
8 + 3 = 11 
Alphabetically, NYC is the 25th entry. Therefore, 



M x24 = 264 = X'108' 
This is the offset to NYC from the start of the table entries. 



026612 

108 

02671A 



start of terminal-name table entries 

offset to NYC entry 

address of the terminal-name table entry for NYC 



From this entry, you can see that the terminal entry for NYC starts at location 
0246D4. 



026560 60029224 C00264FO OC020000 OOCOOCOO 

026580 D44B40C8 C9C7C86B 40E2C806 E4D3C440 

0265AC START OF TABLE D3D< LENGTH OF NAME<,E4D3C4 

0265C0 [T8C18910 00031AFIELD IN BYTES 3004301 

0265E0 FC511810 C7FE0010 [0~8l026767 00271889 

026600 898000C8 43897050 89800008 43897051 

026620 4C404C40 4002471C C1D3C140 40404040 

026640 40404C40 40400247 F4C2C2C2 40404040 

026660 D6E24C40 40404002 4824C3C3 C3404040 

026680 C4E4D C .40 40404040 0246ACC5 C5C54040 

0266A0 78C7C1C9 E4D8404C 4C024640 C7C5E3D8 

0266C0 4618C8C8 C8404040 40400247 A4C8E4Ee 

0266EC 0247BCC3 C9D5C5C1 F 1404002 48ECD3C9 

026700 40024854 03D 6C7C5 0EE3D9E8 02493CD4 

026720 40 40|0246~C4l D7ClD9 E4D84040 40024654 

026740 TERMINAL-TABLE'Cl D3404040 40400246 

026760 ENTRY ADDRESS ;d9 C5D4D6E3 C5F34002 

02678C wtttuiu tuuit-JOO E3C1F240 40404040 

0267A0 E2404C40 40400246 ECE6E3E3 C 1404040 

0267C0 000267CA 000267EO FCF0F1F0 F0F1F1F1 

0267E0 OC00D607 C6C9C5D3 C4400000 E2C3D9C5 

026800 42000COO C0000000 CE0283A8 500283A8 



00000000 0000002F 
C2C540F0 F0F0F24B 
40C2C540 F0F0FOF2 
F04F8900 00084301 
899C0C03 1A981A88 
07F6[C1C1 40404040 
0. START OF3D34040 
^'ENTRIES 206D540 
40wu^i# &4C3C8C1 
40404C02 4778C5E5 
40404040 0245F0C7 
C3D2404C 40024668 
D5C5C1F2 40400249 
C1D9E840 40404002 
D7E4E308 40404040 
9CD9C504 D6E3C5F1 
48ACD9C5 D406E3C5 
024928E3 C5E74040 
4002495C E6E3E3C2 
F0F1F0F1 F0F1FOF1 
C5D5E2E6 0000C3D6 
OOOOOOOC 00026800 



20E2C5D8 4B40D5E4 

372040E2 C5D84B40 

4B370000 C0C265C0 

F0508900 00C84301 

1A981B88 43897C4F 

40400247 04C1C1C1 

40404002 46C0C2C2 

40404040 02478CC2 

D9404040 40024704 

C5D9E840 40400249 

rccaoc-7 CA.en/.rn2 

TERMNAME TABLE \ Q 
ENT RY FOR ' NYC ' >0 
46"h 3D5E8 C3404040~ 
02460 NAME FIELD : 7 
4002486C D9C5D4D6 
F4400248 CCE3C1F1 
40404002 483CE6C1 
40404040 02496400 
FOF1000 3 00C000C0 
D5E5E2E6 4040FF00 
00000000 000245F0 



*- SEQ. NU* 

*M. HIGH. SHOULD BE 0002... SEQ. * 
*NUM. LOW, SHOULD BE 0002 * 



.01, 



.oe. 



*o ...I* 

* £ 6AA ..MAAA* 

* ...ALA ...ATL ...BB* 

* ..4BBB .. BON ...B* 
*OS ...CCC ...CHAR ...* 
*DUR ...EEE ...EVERY ..* 
♦.GARUQ .. GETQ ..0GET2760 .* 
*..HHH ...HUYCK ...III * 
*...LINEA1 ...LINEA2 ...L0CAL1 * 

* ...LOGENTRY...MARY . . JNYC) * 

* ..MPARUQ ...PUTQ ...PUT27* 
*60 ...RAL ...REHOTE1 ..3SREM0* 
*TE2 ...REM0TE3 ...REM0TE4 ...TA1* 

* ...TA2 ...TEX ...MA* 
*S ...HTTA ..6WTTB ....* 

* 001001110101010101 * 

*..OPFIELD ..SCREENSH..C0NVSH ..* 
*.. £ .....0* 



Figure 26. Finding the LCB in a Stand-Alone Dump (Part 2 of 6) 
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Go to the terminal-table entry for NYC at location 0246D4. The last three bytes 
of the first word are the address of the QCB. 

Go to the QCB at location 26AA8. X'20' into the QCB is the address of the 
DCB. 



26AA8 
20 



address of the QCB 

offset into QCB of pointer to DCB 

pointer to address of the DCB. 



26AC8 
At this location, the first byte is the relative line number for the line. 



Go to the DCB at location 0241 8C. The last three bytes are the address of the 
DCB. The last three bytes of the ninth word in the DCB contain the base address 
of the IOB. 



2418C 

1C 

241A8 



address of the DCB 

offset into DCB of IOB base address 

pointer to the IOB base address 



Multiply the value found in the byte located at an offset of X'24' into the DCB by 
the relative line number. Add this result to the IOB base address. 



2418C 

24 

241 BO 

C8 X 1 = C8 

607D8 

+C8 



DCB starting address 

offset to bytes containing IOB size 

address of the byte containing IOB size 

base address of IOB 

size of the IOB 

address of the IOB for this LCB 



608A0 
Subtract X'20' from this address. This is the LCB address. 



608A0 

-20 

60880 



IOB address 

LCB address for terminal NYC 



024680 00010CC4 C00020CO 0C060000 1026413 START OF 00010002 00006000 O0C30COO 

0246AC 01040508 C8000262 1 32A0630 1 8026A20 TERMINAL 00 000000 00080000 023040B8 

0246C0 18026A64 CC0100C4 OCOOCOOO 00080000 TABLE ENTRY [J9 |026AA8| 00020004 O0C02OOO 

0246E0 C0180C0C 01033764 01044780 19026AEC FOR 'NYC' qcb ADDRESS»0000 03C40500 

024700 03004720 19026B30 0C0.10004 00004000 00080000 0404U5UU UUU0D202 1B026B74 

024720 00010001 0000A20C 00000000 0103C008 00010202 00780337 E2010200 05B08B10 



.* 



Figure 26. Finding the LCB in a Stand-Alone Dump (Part 3 of 6) 



026ARO 
026AA0 
026AC0 
026AFC 
026B0C 
026B20 



0C0CC000 (START OF oecooooo 00000000 



8C000C00 
00C0CCC4 
0C120CC0 
OC026AEC 
CC0000C5 



(QCB 

cooooooo 

19057620 
000000C3 
7440057D 



62000000 00000000 
Ol|024 18C| 08O00C19 



'DCB AODRESS'OOOOO 
CC00C000 10241B8 
4C05744C 00057D40 

RELATIVE LINE 

NUMBER 



OC000O0C 00000000 00000000 O0OOO57C 
OE0283A8 400521DC 00000000 00026AA8 
000C1B00 00010000 01000000 O0O00C00 
OCOrCOOC 0E0283A8 60057120 00000000 
08000000 00000000 00000000 00000000 
42000000 00000000 0E026B38 60O283A8 



Figure 26. Finding the LCB in a Stand-Alone Dump (Part 4 of 6) 



024140 17000COO 000249C0 12024B5C 00300040 

024160 00017634 12023110 1 START 17000000 

024180 0102D250 C8COOO00 0( OF DCB [00017594 

0241A0 12C24E5C C03IOB BASE j060708l 0202D350 

0241C0 01020CA8 170ADDRESS O249F0 12024B5C 

0241E0 013C4C40 00016EC4 12023110 010300FC 

024200 04023170 01020350 8CC00000 C4C4F2F7 



02060968 0102D350 C8000000 01C84040 
00024900 12024B5C 00300040 02C608A0 
12023110 010200A8 17000000 OOC249E0 
[C^OOOOOO 011C404C 00016FA4 12023110 
LCB SIZEHO 02057070 01020350 08000000 
1700Q00C 00024A00 2202580C 00300C40 
F6F04040 02004040 01170054 00000000 



,LGH. 



*..LGH * 

*•••*••• •••Q««LuH»«««« ••?•••••* 

* 0...* L&Q...* 

*.. ..>D * 

*•• • • • • L&* • • • D02760 •• ••••••••* 



Figure 26. Finding the LCB in a Stand-Alone Dump (Part 5 of 6) 
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0<START ILCOCOCGO CCOOOOCO OCOOCOOO OOCOCCOO OOOOCOOO OOOOOOOO OOOOOOCO 58DDCC04 * * 

0< OF , CB [EC06Ce80 EC02342C CC060888 40026AB0 00001400 OOOOOOOO 000273FC 18C00CC0 * * 

06CioHu C20COOCO 7F0233E0 OCOOOOOO OOOOCOOO 40060920 0002418C 000305E8 OOCOCCOO *B Y....* 

0608C0 0CC57F2C CC000200 OCOOCOOO 000234B8 E402342C 01057F20 O00OCO19 40C273FC * U * 

0608E0 CCC249F8 51110103 C4C90000 OOCOCCOO OOFFOCOO OOOOOOOO 005800C2 00C00C1D *...8 * 

060900 00054AA0 C002317C 4C0273FC 00C01014 020608F1 BOOOCOCl 080609X0 00C57F20 * 1 * 

060920 0102312D 60000003 C10249F8 6CC00C02 02057F61 80000002 08057F20 OOCOOCOO *....- 8- / * 

360940 0806CS10 COOOOOCO CCC6C948 E002342C 0C060950 200521DC 00001400 10C00C00 * £ * 

Figure 26. Finding the LCB in a Stand-Alone Dump (Part 6 of 6) 

Finding the SCB: LCB+X'5C is a three-byte pointer to the SCB. 

Finding the Message Error Record: The first four bytes of the message error record 
are found at SCB+X'10'. The last byte is found at LCB+X'22'. 



Secondary-Storage Dumps 



Disk Message Queues Dump 



This section discusses TCAM tables and data sets, maintained on secondary- 
storage devices, that you can dump to tape for later printing. Most of these tables 
and data sets are optional in TCAM, and are included or excluded when you code 
your TCAM program. A description of the data in the table or data set and a 
description of what you must do to obtain and print a secondary-storage dump of 
the data follows. 



TCAM handles message traffic using queues. If your queues are in main storage 
only, you cannot dump them with a utility. More commonly, they will be on a 
direct access device or in main storage with disk backup, and you can print them. 
This can help you diagnose, because TCAM records all messages transmitted in 
the system destined for stations with disk queuing. Dump the message queues 
data sets to tape at the end of the day if you wish an up-to-date log of your 
message traffic. Dump them also when you have a disk queuing problem, or when 
you have any problem in which queuing cannot positively be ruled out. 

A TCAM utility program, IEDQXC, prints a formatted dump of all traffic direct- 
ed to stations with disk queuing. You can dump the message queues data set 
sequentially either by record number or by queue. You obtain the most useful 
output by dumping the data set sequentially by queue. See Figures 29 and 30. 

The PARM= parameter on the EXEC statement for IEDQXC determines the 
contents of the dump. The format of the EXEC statement is 

//stepname EXEC PGM=IEDQXC,PARM=' Q=options ' 

Options include 

DMP Prints all messages sequentially by record number. 

xxx,DMP Prints all messages sequentially by record number. Replace xxx 
with the 3-digit decimal total number of queues (see Note 1). 

xxx,ALL Prints all messages sequentially by queue. Replace xxx with the 
3-digit decimal total number of queues. 

xxx,nl nl nl,n2 n2 n2,.. .Prints all messages for queues nl nl nl through n5 
n5 n5 (5 is the maximum number of queues that can be selective- 
ly dumped), xxx is the total number of queues, and nnn is a 
3-digit decimal number corresponding to the queue whose con- 
tents are to appear in the dump. 

The first two options are equivalent to one another and equivalent to omitting the 
PARM= parameter entirely. 
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Note 1: The total number of queues is the number of stations that use that 
particular type of queuing being dumped (reusable or nonreusable). Find the 
total number of disk queues in your MCP assembly listing. In the expansion 
of the macro for the terminal-table entry named by TTABLE LAST=name, 
you will find the instruction 

ORG IEDNADDR 

followed by the instruction 

DC A(n*4+l),A(r*4+3) 

where 

n is the total number of queues on the nonreusable data set, and 
r is the total number of queues on the reusable data set. 

The n or r variable is the maximum value that you can assign to Q=xxx in the 
PARM=parameter. 

Example: 

TTABLE LAST=EVERY,MAXLEN=8 
Figure 27 shows the total number of queues. 

Note 2: Define each extent of the disk data set with a DISKQnn DD 
statement, where nn is the extent number (DISKQ01 is the first extent, 
DISKQ02 is the second, etc.). For single-extent cataloged data sets, DSN= 
and DISP= are the only required parameters. For multi-extent (multivolume) 



TERMINAL MACROS 
LOC OBJECT CODE ADDR1 ADDR2 



SOURCE STATEMFNT 



F15nr.T70 7/14/7] 



33 31 [EVERY] TLIST TYPE=D ,L IST=(NYC , AAA, BBB,REMnTF3 ,R EM0TE4 , RFMOTFl , 

RFM0TE2. AA,RB,POS,TEX,ALA,HUYCK,MARY,RAL,0UR,ATL, 

LOCALl , WAS, CHAR) 



00345e 




00364C 


C5E5C509F8404040 


003654 


001810 


000000 




001810 




001810 


48 


001811 


000000 


001814 


0014 


001816 


COOC 


001818 


000F 


00181A 


0010 


00181C 


CO IE 


00181E 


001F 


001820 


001C 


001822 


0010 


001824 


0016 


001826 


C017' 


001828 


0019 


00182A 


001A 


00182C 


C018 


00182E 


0007 


0C183C 


0008 


001832 


0009 


001834 


000A 


001B36 


OOCB 


0'0183fl 


001B 


001S3A 


0000 


00183C 


000E 


0004BC 




0004BC 


0010000DC000000B 


00183E 




0C365H 




003672 


0CC3 


000000 





3334+IECQTNT 


CSFCT 




3335+EVERY 


OC 


CLR'EVERY' . ENTRY NAME 


3336 + 


DC 


AL3UE039A) 


3338+PDTCAM 


CSECT 




3339*1 F039A 


OS 


OF 


3340+ 


DC 


BLl'01001000« 


3341 + 


OC 


VL3U<E0QBC) 


3342+ 


DC 


Al?<20) . COU 


3343 + 


DC 


AL2((NYC-!EnOTNT-7H/ll) 


3344 + 


OC 


AL2UAAA-IEnQTNT-71)/ll) 


3345 + 


PC 


AL2UBBB-IF00TNT-7l)/ll) 


3346 + 


OC 


AL2UREM0TE3-IEDQTNT-71)/11 ) 


334 7+ 


nc 


AL2( (REM0TE4-IEDQTNT-71 )/U) 


3348 + 


DC 


AL2HREMOTE1-IEDQTNT-71I/11) 


3349+ 


OC 


AL2« (REM0TE2-IEDQTNT-71 )/ll ) 


3350+ 


DC 


AL2((AA-IE0QTNT-7l J/1 I) 


3351 + 


DC 


AL?((BB-IE00TNT-711/U) 


3352+ 


DC 


AL?({B0S-IFD0TNT-71 )/H ) 


3353+ 


nc 


AL?((TEX-IF00TNT-7l)/ll) 


33 54 + 


OC 


AL2< (ALA-IFOQTNT-71 l/ll) 


3355+ 


nc 


AL?((HUYCK-IE0QTNT-71 l/ll) 


3356 + 


cc 


AL2((MARY-IEO0TNT-71)/ll) 


3357+ 


nc 


Al ?J (RAL-IFOQTNT-71 l/ll) 


335B+ 


nc 


AL2((DUR-IFO0TNT-7 1)/ll) 


3359 + 


DC 


AL?t(ATL-IFnOTNT-71)/ll) 


3360+ 


DC 


AL2( (LOCALl-IFnOTNT-71 )/l 1) 


3361+ 


nc 


AL2( (WAS-IEnOTNT-711/111 


336?+ 


DC 


AL?{(CHAR-IEnQTNT-71)/ll ) 



3364+ 
3365 + 



COUNT OF TLIST FNTRIFS 



ORG 
OC 



3366+ ORG 

3367+IECOnPT CSECT 
3368+TECCOPTN DC AL?(3) 
3369+POTCAM CSFCT 



IEDNAnOR 
A((j"q).4+l,A<(ro)«4-H) 



'10 STATIONS HAVE REUSABLE DISK QUEUING 



10 STATIONS HAVE NONREUSABLE DISK QUEUING 



Figure 27. Finding the Number of Queues in a TCAM System 
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data sets, the catalog information cannot be used. Each DD statement must 
define the volume identification in the same order as the volume identification 
listed in the IEDQDATA DD statement for the disk initialization program 
IEDQXA. 

IEDQXC issues an OPEN for the maximum number of extents permitted (16). 
Therefore, on your JCL printout, ignore the message 

■IEC103I DISKQnn DD STATEMENT MISSING 

where nn is a number from 2 to 16. The program runs successfully without these 
DD statements if they are not applicable. 

Example: The following JCL lists all queues from a multivolume data set: 

//jobname JOB 

//stepname EXEC PGM=IEDQXC, PARM= ' Q=xxx , ALL' 

//DISKQ01 DD DSN=dsname,DISP=OLD,UNIT=23xx,* 

// VOL=SER=xxxxxx 

//DISKQ02 DD DSN=dsname, DISP=OLD , UNIT=23xx, * 

// VOL=SER=xxxxxx 

//SYSPRINT DD SYSOUT=A 

/* 

where dsname is the same name you assigned the disk data set when you executed 
IEDQXA to preformat the disk. 

The queues may be long. Therefore, you can select specific queues to dump, up to 
a maximum of 5. To determine the queue number for the station whose message 
queue you want to dump, refer to your assembly listing. The queue numbers are 
assigned in the order in which you coded the TERMINAL macros. Therefore, the 
first TERMINAL macro having nonreusable queuing is queue number 001 on the 
nonreusable disk data set. The same is true for reusable queuing. 

You must keep two things in mind. First, if you are queuing by line (QBY=L), 
TCAM assigns only one queue to all terminals on the line. Second, if you have 
priority levels (LEVEL=), then TCAM assigns each priority level a queue, and all 
terminals with priority levels have an additional level of zero; therefore, there is 
one more queue than the number of levels you list in the operand. For instance, 
LEVEL= (24 1,242) generates three queues on the data set for that terminal. 

Example: 

NYC TERMINAL QUEUES=MN ,QBY=T, LEVEL=( 240 , 247 ) . . . 

KAN TERMINAL QUEUES=MO / QBY=T, . . . 

KIX TERMINAL QUEUES=DR,QBY=L, LEVEL=( 241 , 243 ) . . . 

BOS TERMINAL QUEUES=MR, QBY=L, LEVEL=( 24 1 , 243 ) . . . 

ALA TERMINAL QUEUES=DN , QBY=T . . . 

FLA TERMINAL QUEUES=MO, QBY=T . . . 

GAL TERMINAL QUEUES=DN ,QBY=T, LEVEL=( 242 , 244 ) . . . 

RAL TERMINAL QUEUES=DN , QBY=T . . . 

BON TERMINAL QUEUES=DR , QBY=T . . . 

WAS TERMINAL QUEUES=MR,QBY=T . . . 

ATL TERMINAL QUEUES=MN , QBY=T . . . 

On the reusable disk data set, the stations have the following queue numbers: 

KIX LEVEL 243 QUEUE 001 

LEVEL 241 QUEUE 002 

LEVEL QUEUE 003 

BON QUEUE 004 

WAS QUEUE 005 
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Note: BOS has the same queue numbers as KIX, since they are queued by 
line. 

On the nonreusable disk data set, the following queue numbers are assigned: 



NYC 


LEVEL 


247 QUEUE 


001 




LEVEL 


240 QUEUE 


002 




LEVEL 


QUEUE 


003 


ALA 




QUEUE 


004 


GAL 


LEVEL 


244 QUEUE 


005 




LEVEL 


242 QUEUE 


006 




LEVEL 


QUEUE 


007 


RAL 




QUEUE 


008 


ATL 




QUEUE 


009 



Therefore, if you are interested only in the traffic directed to NYC, use the 
following EXEC statement: 

//stepname EXEC PGM=IEDQXC, PARM= 'Q=009 , 001 , 002 , 003 ' 

009 is the total number of queues on the nonreusable disk data set. 

Run IEDQXC separately to dump the reusable and nonreusable disk queues, since 
the DSN= parameter on the DISKQnn DD statement must be the name you 
assigned when you executed IEDQXA to preformat the disk, and you must define 
and preformat two data sets, one reusable and one nonreusable. 

If you cannot dump your message queues data set because it is too large, either 

1. code a SPACE= parameter on your SYSPRINT DD statement if you are using 
a SYSOUT queue (the SPACE= default on your system may not be large 
enough to contain the entire dump), or 

2. allocate SYSPRINT directly to the unit on which you wish to dump the queues 
(printer, magnetic tape, or disk). 



The output from the IEDQXC utility program contains a great deal of information 
about the message, including its source terminal, destination terminal, and how 
TCAM processed it. The column headings on the printed output correspond to 
the 30-byte buffer prefix for each message. See Figure 28. 

Heading Explanation 

NT The number of units in the buffer. TCAM determines 

this using the KEYLEN= operand (the number of bytes 
in one unit) on the INTRO macro and the BUFSIZE= 
operand (the number of bytes in one buffer) on the TER- 
MINAL macro, if specified, or the DCB macro for the 
station. 

LCB The LCB (line control block) address for the source 

terminal. 

SRCE The terminal-name table offset for the source of the 

message. The number is the position of the source termi- 
nal alphabetically in a list of all terminals. 

SIZE The number of bytes of data in this buffer. 

ST The status byte, which is the state of the buffer when it 

was written on the data set. 
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Value 
X'80' 
X'40' 
X'20' 
X'10' 
X'08' 
X'04' 
X'02' 
X'01' 
X'OO' 



Meaning 

message has been canceled 

this buffer contains an error message 

not used 

this is a TSO buffer 

this is a duplicate-header buffer 

SETEOF was executed 

this is not the last buffer of the message 

this is not the first buffer of the message 

only one buffer is in the message 



NXTREC 



Pointer to the next unit in the buffer. 



SCAN 



NXTTXT 



Hexadecimal offset from the beginning of the buffer 
prefix to the location of the scan pointer. The offset 
is in the first byte. 

Pointer to the next buffer in the message if this is 
not the last buffer, or the message queue-back chain if 
it is the last buffer. 



FSTREC 



Pointer to the first unit of the current header buffer. 



NXTHDR 



QBACK 



SEQO 



DEST 



Pointer to the first buffer of the next message (the 
next-header segment). 

Queue-back chain of the first buffers of messages (the 
chain of header segments). 

The input sequence number. 



The terminal-name table offset for the destination of 
the message (the position of the destination terminal 
alphabetically in the list of all terminals). 

In addition to the information in the prefix, information about the message is in 
the last six bytes of every record, which is the data field of the disk record. 

If byte is X'80\ then the record has no prefix; it is an extra record. The next 
three bytes contain the disk address of this record. The fifth byte contains the 
number of bytes of valid data in the record. The last byte is unused. See Figure 
28. 



If byte is not X'80', then the record does have a prefix. 

If byte is X'OO' and the ST field of the prefix is X'01', then the record is all text. 
The remaining five bytes of the data field are unused. See Figure 28. 

If byte of the data field is X'OO' and the ST field is not X'01', then the record is 
a header record that has not been serviced (the message has not yet been sent 
successfully). The last two bytes are unused. See Figure 28. 

If byte is X'40', then the record is a header record for a message that has been 
serviced. The next three bytes contain a pointer to the next FEFO header record, 
and the last two bytes contain the output sequence number (a sequential count of 
the records on the queue). See Figure 28. 
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If the first byte of the data field is X'20\ then the record is a header record with a 
prefix, and it has been canceled (not transmitted). 

It will help you diagnose queuing problems by having all your terminals on some 
type of disk queue, either disk queuing or main-storage queuing with disk backup 
because it gives you a permanent record of message traffic and processing. 

Figure 29 shows a sequential-by-record dump and Figure 30 shows a sequential-by- 
queue dump. 
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NT LCB SRCE SIZE ST NXTREC SCAN NXTTXT FSTREC NXTHOR QBACK SEQO DEST 
020651AC 0019 C058 OC OCOOOE C045 COOOCC OOOOOC OOOOCD 00CC2O 0005 0C19 

ACD5E8C3 40F5A0FC F84BF5F2 ABFAF8AC *..RH....X X NYC 5 08.52.48 * 

C5D9D4C9 D5C1A0C0 00000003 *EVERY / TO ALL TERMINA * 

220CC022 000020E6 C9E3C3C8 C5CACC00 *LS.* WITCHED..* 

E8C3A0F4 A0ACF8AB F5F2A BF3 FAA0C3C8 *ERMINALS .*..X NYC A 8.52.3A CH* 

C8C5A0E2 |80j0OQOPE|OA|?O| UNUSED *AR WAS / HI TO THE S * 

/ ■ — J 



0CCCC90A AFC1CAB1 E7C1C701 151C76E7 
C5E5C5D9 E-END OF VALID DATA 03D3A0E3 
03E21537JC0000036 02CC9009 OOOOOOOC 
C5DSCAC9 D5C1D3E2 A0153710 76E7A0D5 
C109ACE6 C1E2A061 ACC8C9A0 E306A0E3 




TEXT RECORD 



NT LCB SRCE SIZE STl NXTREC SCAN NXTTXT FSTREC NXTHDR 
01C651AC 0019 0C53 (cT) 000000 OOCO 000036 OOOOBA OCOOBO 
D3C1A0E3 C5E7A061 AOC1A0OA C5E2E2C1 C7C5A0CA C5E2E3C9 D5C5CAA0 C6D6D9A0 



C5C1C3C8 A0E3C5D9 DAC9D5C1 D3A0C9D5 CAC9E5C9 CAEAC1D3 D3E 81537 15 0CI0COO 



FIELD 



DATA 



RECORD HAS 
A PREFIX 



*LA TEX / A MESSAGE DESTINEO FOR * 
*EACH TERMINAL INDIVIDUALLY.*....* 
*... * 



HOROOOOAD 



0C0CB3 



DUPLICATE HEADER 
SETTING 



NT LCB SRCE SIZE ST NXTREC SCAN 

020651AO 0019 0096 [08J 00OOA9 0055 
0000D9DA AF01CAB1 E7010701 151076E7 
C1C1A0C1 C1C1A0C2 C2A0C2C2 C2A0C9C9 
61A0E3C8 C9E2A0E6 C9D3D3A0 C2C5A0D6 
C5ACE3C8 C5E2C5AC E3C509DA C9D5C1D3 
15370115 10760B07 760A0201 F0EBC6C6 




NXTTXT FSTREC NXTHDR QBACK SEQO DEST 

000002 000001 OOOOAD OOOOOC C007 0011 

A0D5E8C3 A0F 740F0 F8ABF5FA ABF0F1A0 *..RM....X X NYC 7 08.5A.01 * 

C9A0C8C8 C8A0 IO0I0O OOAOlOOOO I DATA FIELD *AA AAA BB BBB III HHH * 

D5A0E3C8 C5AC08EA 1C5E VuNUSED2C9D5C3 */ THIS WILL BE ON THE QUEUE SINC* 
E2ACC1D9 C5AOD5D6 JE3A0C1C3 E3C9E5C5 *E THESE TERMINALS ARE NOT ACTIVE* 
CC01A6CC 80000049/4200 *.* ...O.FF..$ * 



NT LCB 
020651AO 



SRCE 
0019 



SIZE 

O0A8 



OOO0E2C1 C7C5E2A0 D6D5A0E3 C8C5A0E7 
A0C1C1C1 A0C2C2C2 40D9C5D4 D6E3C5F1 
C5F2A0D9 C5DAD6E3 C5F3A009 C5DAD6E3 
A0C1C1A0 C2C2A0D5 E8C3A0E6 C1E2A0C3 
ACC6EAE8 C3D215C9 C9C9A0C8 C8C8A0C2 



QBACK 
00C001 

A0D5E8C3 A0F1F3A0 F0F8ABF5 F8ABF2FA 
A0D9C5DA D6E30000 00000000 
C5FAA0D3 D6C3C1D3 F1A0D3D6 C3C103F2 
C8C1D9A0 C1E3D3A0 CAEAD9A0 CAC1D9E8 
D6E2A0C1 800000B3 5A00 



SEQO 
OOOD 



DEST 
0011 



*.. SAGES ON THE X NYC 13 08.58.2A* 

* AAA BBB REM0TE1 REMOT * 

*E2 REM0TE3 REMOTEA L0CAL1 L0CAL2* 

* AA BB NYC WAS CHAR ATL OUR MARY* 

* HUYCK.III HHH BOS A * 



SERVICED HEADER BUFFER 

HDRCOOClA NT LCB SRCE SIZE ST NXTREC SCAN NXTTXT FSfTREC NXTHDR QBACK SEQO DEST 

0206E1A0 0019 CC6D 00 00001C OOAB 00001A 00001A 00001B 000013 0009 0019 

0000C5C9 E5C5A0E3 C8E2C9A0 DAC5E2E7 A0D5E8C3 A0F9 A0F0 F8ABF5FA ^Qmfmp> *..EIVE THSI MESX NYC 

C5E5C5D9 E8A0C5E5 C5D9E8A0 61ACE3D6 A0C1D3D3 A0E3 |aQ|0C 001B|C006| - M .| Unrn *EVERY EVERY / TO ALL 

00C01C C5D9DAC9 D5C1D3E2 15D6D5C5 A0DAD6D9 C5A0E3C9 DAC5A015\37110008 uCT^vlruv fc " *ERMINALS.ONE MORE TIME .* * 

C5A0E3C8 C5E2C5A0 E3C5D9DA C9E7A0D5 E8C3A0F8 A0F0F8AB JF5FAABF 3 F1A0D9C5 *E THESE TERMIX NYC 8 08.5A.31 RE* 

DAD6E3C5 F1A009C5 0AD6E3C5 F2A0D9C5 DAD6E3C5 8000001C/1900 *M0TE1 REM0TE2 REMOTE * 



08.5A.52 



NT LCB SRCE SIZE ST NXTREC SCAN NXTTXT FSTREC NXTHDR QBACK SEQO DEST 
020651AC 0O19 CC6D 08 00001C OOAB 00001B 00001B 000C21 00002B 0009 0019 
0C0CC5C9 E5C5ACE3 C8E2C9A0 DAC5E2E7 ACD5E8C3 A0F 9A0F0 F8ABF5FA SEQUENCE *..EIVE THSI MESX NYC 9 08.5A.52 * 

C5E5C5D9 E8A0C5F5 C5D9E8A0 61APE3D6 ACC1D3D3 A0E3 K0I0C 0021100071 QUT NUMBER * EVERY EVERY / TO ALL T * 

C5D9CAC9 D5C1D3E2 15D6D5C5 A0DAD6D9 C5A0E3C9 DAC5A015 37110008 wivutfu *ERMINALS.ONE MORE TIME .* * 

C5ACE3C8 C5E2C5AP E3C5D9DA C9E7A0D5 E8C3A0F8 A0F0F8AB F5FAABF3 F1A0D9C5 *E THESE TERMIX NYC 8 08.5A.31 RE* 
DAD6E3C5 F1A0D9C5 DAD6E3C5 F2A0D9C5 DAD6E3C5 8000001C 1900 *M0TE1 REM0TE2 REMOTE * 



Figure 28. Message Queues Data Set Printout 
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♦ ♦♦ SPECIAL CHARACTERS- EGT= *, EGB= *, ECA= * ** 

NT LCB SRCE SIZE ST NXTREC SCAN NXTTXT FSTREC NXTHDR QBACK SEQO DEST 
OOOOOl IODOCOOOC<|0000|0039)|OC|000000||1EOO|OOCO OdOOOOCll lOOOOOBJOO OOOQ|0000||0019| 5C5C 
"^^■£ £505040 40E3C3C1 C44009E4 0505C905 CJK0405C 5C5iC5C5C 3790ECD0 0CC5A041 
F0ACCE58 ED000C98 0CU014U/ HblLSLbl 5C5C5C4C 40C00000 0001 



000002 02077C58 00120059 0800000F 4D0F0000 
9C9C9001 01A6E7E2 C901D2A9 CAE740C8 
C5E5C509 E840C5E5 C5D9E840 6140C8C9 



10000002 OOdOlOOO 00000001 C0C20C00 
E4E8C3D2 40F140FO F94BF0F7 4BF2F240 
40E3D640 00/000010 OOOO 



* ♦ ** 

**** TCAM RUNNING ****** * 

*0 $......***** ..... * 



* SXSI.KJ.X HUYCK 1 09.07.22 * 

*EVERY EVERY / HI TO * 



000003 02C77C58 0C120059 0800000F 4D0F0000 
909C5001 01A6E7E2 C9C102A9 CAE740C8 
C5E5C5D9 E840C5E5 C5D9E840 6140C8C9 



02000003 QfOOOllOO 00000001 00C60000 
E4E8C3D2 A0F140F0 F94BF0F7 4BF2F240 
40E3D64C/00000011 0000 



* $XSI.K$.X HUYCK 1 09.07.22 * 

♦ EVERY EVERY / HI TO * 



000004 OOOCOOOO 00000000 00000000 OOCOOOOO 
OCOCOCOO 00000000 00000000 OOOOOOOC 
OOOCCOOC 00000000 00000000 00000000 



00000000 OOOOOOOC 00000000 cocoocoo 
00000000 oooooooo oooooooo cooocooo 

00000X00 OOOOOOOO 0000 



000005 ocoooooo oooococo OOOOOOOO OOOOOOOC 
cccccooc ooooooco ccooocoo OOOOOOOO 
ococcooo OOOOOOCO OOOOOOOO OOOOOOOO 



OOOCOOOO OOOOOOOO OOOOOOOO OOCOCCOO 
3000000 COOOOOOO OOOOOOOC OOCCOCOO 
•'OOOCOOOO OOCOOOOO 0000 



000006 CCCCCOOC OOOOOOOO OOCOOOOO OOOOOOOC 
OCOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
COOCOOOO OOOOOOOO OOOOOOOO 004000CC 



COOOOOOO oooooooo oooooooo coccocoo 
OOOOOOOC OOOOOOOO OOCOOOOO oocoocoo 
ooooocoo OCCOOOOO 0000 



000007 02077058 0C120059 080000QP' 4D0F0OOO 
9C9C9001 01A6E7E2 C901D4A9 CAE740C8 
C5E5C509 E840C5E5 C5&9E840 6140C8C9 



0300CC07 00001200 00000001 00200COO 
E4E8C3D2 40F140FO F94BF0F7 4BF2F240 
40E3D640 00000012 0000 



* JXSI.KS.X HUYCK 1 09.07.22 * 

♦ EVERY EVERY / HI TO * 



000008 02C77058 001200S»T 0800000F 4DCF0000 
9C9C9C01 01A6^/E2 C901D2A9 CAE740C8 
C5E5C5D9 E8AOC5E5 C5D9E840 6140C8C9 



070COOC8 00001300 00000001 C0210C00 
E4E8C302 40F140F0 F94BFCF7 4BF2F240 
40E3D640 OOOC0013 0000 



* $XSI.K$.X HUYCK 1 09.07.22 * 

♦ EVERY EVERY / HI TO * 



OCOCCCO^OOOOOOOO OCOOOOOO OOCOOOOO 
oooooecc OOOOOOOO OOOOOOOO OOOOOOOO 
ccoefcoc OOOOOOOO OOOOOOOO OOOOOOOC 



OOOCOOCO OOOOOOOO OOOOOOOO COCOOCOO 
OOOCOOOO OOOOOOOO OOOCOOOO OOCOOOOO 
OCOCOOOO OOOOOOOO 0000 



OOOOOA /OCOCOCOC OOOOOOOO OOOOOCOO OOOOOOOO 
OOOCOOOC OOOOCOOO OOOOOOOO OOOOOOOO 
COOCCCOC OOOOCOCC OOOOOOOO OOOOOOOO 



OOOOOCGC OCOOOOOO OOOCOOOO ooooocoo 
cooocooo oooooooo oooooooo OOCOOOOO 

OCOOOCCC OOOOOOOO 0000 



OOOOOB |O2)Q6ACD8||0019|CO88||OOp0OO0D| |890F|0000 OE)OOOCOB| |O0OOOC|O0 0000|0C0l| |O019| 0C00 



OOOOOC 



oooc 




020TZOW00120059 0OCOOO0F 400F0000 

JCSOOl C1A6E7E2 C90102A9 CAE740C8 

'C5E5C5D9 E840C5E5 C5D9E840 6140C8C9 

C64CE2E8 04C2D6D3 E26B6B6B 4F4F4F4B 
7BF3F3F3 5E5E5E7A 7A7A6C6C 6C7D7D7D 
F0ACCE56 ED00CC98 0CD01407 FE1C5C5C 



O5E8C340 &I40F0F9 4BF0F64B F1F540D5 

"xsce^wr^oooooco 0002 

OOOOOOCC COOOOEOO 00180001 0019CC00 
E4E8C3D2 40F140F0 F94BF0F7 4BF2F240 
40E3D64C 4000000E 0003 

4B4B5F5F 5F5A5A5A 5B5B5B7F 7F7F7B7B 
7D7D1537 5C405C5C 3790ECD0 0CC5AC41 
5C5C5C4C 8000000D 3400 



*...Q.. .$....$ * 

* $XSI.K$..X NYC 1 09.06.15 N* 

*YC THIS IS A BUNCH * 



* JXSI.KS.X HUYCK 1 09.07.22 ♦ 

♦ EVERY EVERY / HI TO * 

*F SYMBOLS.,, ... $$$...*** 

*#333 ... ,,,,, .** *** * 

*0. .....$.... ..***** ...... * 



OOCCOE 02077058 OC120059 0800000F 4DOF0OCC 
9C9C9C01 01A6E7E2 C901D2A9 CAE740C8 
C5E5C509 E840C5E5 C5D9E840 6140C8C9 



C50000CE 0000140C O0OC0OC1 00190COO 
E4E8C3D2 40F140FO F94BF0F7 4BF2F240 
40E3D64C 4000000C 0004 



* $XSI.K$.X HUYCK 1 09.07.22 * 

♦ EVERY EVERY / HI TO * 



C1D3C315 37000039 0806CA61 1E00000C 
5C5C5C4C 40E3C3C1 D440D9E4 D505C905 



OOOCOOOO OOOOOOCC OCOOOOOO C0185C5C 
C740405C 5C5C5C5C 3790ECD0 0CC5AC41 



♦ALL.* / ♦♦♦ 

♦♦** TCAM RUNNING ****** * 



Figure 29. A Sequential-by-Record Dump 
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SOURCE TERMINAL 
I8TH TERMINAL 
ALPHABETICALLY 



THIS IS THE LAST 

BUFFER SO POINTER POINTER TO FIRST 

TO PRECEDING BUFFER OF NEXT 

TEXT BUFFER MESSAGE 



LCB ADDRESS 
FOR SOURCE 
TERMINAL 



********** firs'! 

• ■*. 2 UNITS IN 

X BUFFER ^ 
HDB000C02 NT LCE 




SRC 



SIZE OF 
MESSAGE 
= 89 BYTES 



QUEUE 0OCCO2 
STATUS 
BYTE 

size st nxtrec 



POINTER TO NEXT 

UNIT OF THE 

MESSAGE 

SCAN 
POINTER 
******* OFFSET 



POINTER TO 1ST 
UNIT OF 
CURRENT BUFFER 



r 1 t 



NO QUEUE-BACK 
CHAIN OF FIRST 
BUFFERS SINCE 
THIS IS THE FIRST 



INPUT 

SEQUENCE 

NUMBER 



SCAN NXTTXT FSTREC NXTHDR QBACK SEQO 



00121 |0C59l |CB| lOOOOCFl |CC40| lOOOOlol |000002| loOOOlol lOOOOOCl lOOOll 100021 



DESTINATION TERMINAL- 

2ND TERMINAL ALPHABETICALLY 

DEST 



00101A6 E7E2C901 /D2A9CAE7 

C5£5C5Dy E840614C 

7C00C39 tfBTtfffffM 1ECC0"6TC~ 

40E3C3C1 D't40D9E4 D5C5C9C 

D00CC98 CCD01407 FE1C5C5C 



40C8E4E8 C3D^40F1 40F0]F94B F0F74BF2 
C8C940E3D6<C0000 00100000 
COOOCOet^COOOOOCO COO/OOOO 00185C5C 
.040 5C 5C5C5C5C 3Z40ECD0 0C05AC41 
5C5C5CAC 8000000E^0500 



* $XSI.K$.X HUYCK 1 09.07.2* 

*2 EVERY EVERY / HI TO * 

♦ ALL.* / *** 

**** TCAP RUNNING ****** * 

*0. .....$......***** ...... * 



HDROOOC 



NT LCE SRCE SIZE ST NXTREC SCAN NXTTXTXfSTREC NXTHOR QBACK SEQC DEST 

C2|C77C58| |0012| |0C59| |08| [C0000F| [GOAD! |0C000e| |000010| |000015l |0C0C02| |0001| |0QQ2| 



40C8E4E8 C30240F1 40f0F94B F0/74BF2 

C8C940E3 06400000 OOOOOOOO 

OOOOCOOC COOOOJ10C OOOOOOOC #0185C5C 

3790ECD0/0C05AC41 




* $XSI.K$.X HUYCK 1 C9.07.2* 

*2 EVERY EVERY / HI TO * 

*ALL.* / *** 

**** TCAK PUNNING ****** * 

*0. .....$..»•••***** ...... * 



Figure 30. A Sequential-by-Queue Dump 



Checkpoint/Restart Dump 



The optional TCAM checkpoint/restart facility restarts the TCAM system with a 
minimum loss of message data following system failure. To do this, TCAM 
periodically records, in a special data set on disk, the status of each station, 
destination queue, terminal-table entry, and invitation list in the system. When 
the system starts up after closedown or failure, TCAM uses this information to 
restore the MCP environment to its condition before closedown or failure. 



Log Data Set Dump 



No TCAM utility dumps and formats the checkpoint data set. The best way to 
dump it is to use the OS service aid IMASPZAP (see Service Aids, GC28-6719, 
for details). You can use the following sample JCL to dump the checkpoint data 
set: 

//DUMPCHK JOB MSGLEVEL=1 

//STEP EXEC PGM=IMASPZAP 

//SYSLIB DD DSNAME=CHECKPT,DISP=SHR,UNIT=23xx,* 

// VOL=SER=xxxxxx 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

ABSDUMPT ALL 
/* 

This JCL dumps the entire data set named on the SYSLIB statement in hexadeci- 
mal, with the EBCDIC translation and the mnemonic equivalent of the data. 

Dump the checkpoint data set if you have any trouble restarting a system. As a 
precautionary measure, also dump at the end of the day if you plan to start the 
next day with a warm or continuation restart. If you cannot restart the system, 
immediately compare the dump from the preceding day with a dump of the current 
checkpoint data set to see if the data set was inadvertently scratched. If the 
dumps are identical, there may be a problem in the restart facility. 



TCAM's message-logging facility records, on a sequential data set, the message 
traffic handled by an MCP. The LOG macro instruction records either a message 
or a message segment on a log data set while the message is being processed by an 
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MH subgroup. The LOG macro operand and the subgroup in which you code the 
LOG macro determine which is to be logged — message segments or complete 
messages. Anticipate the need for diagnostic aids in designing your MCP by 
including logging. Once your program is error-free, you can easily remove the log 
without rewriting the MCP. You should be aware that the LOG macro has an 
implied WAIT in its execution. Logging a segment impacts the system perform- 
ance more than logging a message. If you are logging both segments and mes- 
sages, define a separate data set for each. Once the log data set is filled, normal 
processing continues but logging is suspended. See the TCAM Programmer's 
Guide for details on how to code for segment and message logging. 

Examine the log segment or log message output for a quick diagnosis of errors 
while debugging the MCP. Dump the log data sets when you have any problems 
in your MCP. By examining them you can see what message handler processing 
has been performed on each message, and you can see in which subgroup the 
message becomes incorrect. Dump the log data sets periodically and analyze your 
message traffic to be sure you are using your resources efficiently. You can also 
dump the log data sets as an accounting record, since they show all messages 
processed by your MCP. 

Dumping the Log Segment Data Set: To dump the log segment data set use the 
TCAM utility IEDQXB. This utility prints a hexadecimal dump of the segment (a 
segment is the number of bytes in the KEYLEN= operand of the INTRO macro), 
with an English translation on the right. Thus, you can easily find your messages, 
and you also have the prefix of the header buffer for debugging. 

The following sample JCL prints the log segments from the data set LOGMSG 
located on disk. The data set was created at MCP execution time. 



=OLD, 



Using the Log Segment Dump: The log segment facility records each segment 
processed by the message handler. TCAM places segments on the log data set in 
the sequence in which they are handled. Therefore, the segments of one message 
are likely to be intermixed with the segments of other messages on the data set. 
Figure 31 shows the log segment output produced by the utility IEDQXB. The 
LOG macro was included in the inheader subgroup before any processing, and in 
the outbuffer subgroup after all processing. The log segment entries for the 
message are on the log data set sequentially, although segments of other messages 
may be intermixed. Each time the LOG macro is executed, an entry is made into 
the data set. Therefore, there should be a one-to-one correspondence between 
the number of entries for a message and the number of LOG macros in the 
message handler. If you do not have the same number of log segment entries as 
you have LOG macros, then you know when, in message handler processing, you 
lost the message. 

In Figure 31 the message is directed to two terminals; therefore the buffer seg- 
ment passes through the outgoing message handler twice. By examining the 
buffer prefix (the destination offset or the LCB if you have a dump of main 
storage), you can tell which terminal received the message first. Also, the time in 
the output message shows the response time of the system. 
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//PRINTSEG 


JOB 


MSGLEVEL=1 


//EDIT 


EXEC 


PGM=IEDQXB 


//SYSPRINT 


DD 


SYSOUT=A 


//SYSUT1 


DD 


DSN=LOGMSG,UNIT=231 1 ,DISP 


// 




VOL=SER=1 11111 


/* 







By examining the log segment, you can see how the buffer is processed, which can 
be helpful when you are debugging your message handler. 



Dumping the Log Message Data Set: No TC AM utility prints the output of the 
message log data set. The best way to get the dump is to use the OS utility 
IEBPTPCH. The prefix of a buffer on the log message data set is of no value. Use 
of the log message function (LOGTYPE macro) causes any useful information in 
the logged message prefix to be overlaid. Therefore, you may want to get only an 
English translation of the data set contents. The following sample JCL dumps a 
log message data set from an unlabeled tape. The FIELD= and LRECL= values 
are the same as the value specified in the KEYLEN= operand of the INTRO 
macro. 



//PRINTMSG 

//DUMP 

//SYSPRINT 

//SYSUT1 

// 

// 

//SYSUT2 

//SYSIN 
PRINT 
RECORD 

/* 



JOB MSGLEVEL=1 

EXEC PGM=IEBPTPCH 

DD SYSOUT=A 

DSN=MSGLOG , UNIT=2400 , LABEL=( , NL ) , : 

VOL=SER=LOGTYP , DISP=OLD , * 

DCB=( RECFM=FU , LRECL=84 , RLKSIZE=1 6S 

SYSOUT=A 

* 

MAXFLDS=1 
FIELD=( 84 ) 



DD 



DD 
DD 



♦♦UNKNOWN TRACE ENTrY TYPE** 



LENGTH- 0054 



020651A0 00000036 02000000 00000000 
37D4C9D5 C1D3E215 375E5E56 5EE740D5 
D9E640C8 E4E8C3D2 406140C8 C940E3D6 
♦♦UNKNOWN TRACE ENTRY TYPE** 



1A00001A 0000174C F1F0F5F0 7DE20C00 
E8C340F2 4040F84B F5F14BF5 F340D4C1 
40E3C8C5 00404040 40404040 40404C40 
LENGTH- 0054 



0204S1AC 00190061 000690C0 00430000 
D9D4E740 D5E8C340 F340F0F8 4BF5F24B 
4BF1FC4C C8C5D303 D640E3D6 40D4C515 
♦ ♦UNKNOWN TRACE ENTRY TYPE^ LENGTH- 



OC0690CO 0690C000 00150003 00190000 
F0F740D5 E8C34061 40F240F0 F84BF5F2 
17171717 00404040 40404040 40404040 
0054 



17171717 17171717 

37D4C9D5 C1D3F215 

D9Ee40C8 E4E8C3D2 

♦♦UNKNOWN TRACE ENTRY TYPE** 



17171717 37000000 
375E5E5E 5EE740D5 
406140C8 C940E3D6 

LFNpTH- 



1F00001F 00001D40 
E8C340F2 40F0F84B 
37E3C8C5 D74O404P 
00;^ 



INHDR 

LOG 

ENTRY 



I020651AC 00190068 00000000 003D0000 OOOOOOOB 0690C000 



D9D4AF01 CAB1E701 
C1D940E6 C1E24061 
♦♦UNKNOWN TRACE ENTRY TYPE** 



07C11510 760B0476 
40C8C940 E3D640E3 
LENGTH- 



**UNKN0WN 
OUTBUF 
LOG 
ENTRY 



E6C9E3C3 C8C5C440 E3C5D9D4 C9D5C1D3 

0904C9D5 C103E215 375E5E5E 5EE740D5 

C34C6140 C8C5D3D3 D640E3D6 40D4C515 

TRACE ENTRY TYPE** LENGTH- 



150E01CA B116E740 
C8C540E2 47404040 
0054 

E2401537 00000000 
E8C340F3 40F0F84B 
37E3C8C5 00404040 
0054 



F1F0F5FO 7DE24B15 
F5F14BF5 F340D4C1 
40404O40 4r»404C40 
BUFFER 
PREFIX 
00150004 0019|0 000 



|03065CCe 0019C078 OCC68AO0 00480000 00068A00 068A0000 



D5E8C340 F440C3C8 
40404040 40 40 4C 40 



0015000 3 00190C0C 
F5F24BF0 F74CD5E8 
40404040 40404C40 
BUFFER 
PREFIX 
00150004 OOCAl OCOO 



D9D4E74C D5E8C340 
F0F84BF5 F24BF3F4 
♦♦UNKNOWN TRACE ENTRY TYPE** 

E6CSE3C3 C8C5C44C 

17171737 40E3C3C1 

F0ACCE58 E0000C98 

**UNKNOWN TRACE ENTRY TYPE** 

03065CC8 0000C024 
5C5C5C40 40E3C3C1 
F0AC0E58 E000CC98 
TRACE ENTRY TYPE** 



♦♦UNKNOWN 
OUTBUF 
LOG 
ENTRY 



F440F0F8 4BF5F24B 
4CC8C940 E3D640E3 
LENGTH- 

E3C50904 C9D5C1D3 
044009E4 D5D5C9D5 
0CD01407 FE1C5C5C 
LENGTH- 

02000000 00000000 
D44009E4 D5D5C9D5 
0CDC1407 FE1C5C5C 
LENGTH- 



F3F440C3 
C8C540E2 
0C54 

E2401517 
C7404C5C 
5C5C5C4C 
0054 

C0C68C37 
C74C40 5C 
5C5C5C4C 
0054 



C8C1D94G 
47404040 



17171717 
5C5C5C5C 
9140404C 



00000000 
5C5C5C5C 
004C4040 



I03CC5CC8 00190078 08C65620 00480000 C0065620 06562000 



E6C1E240 6140F240 
40404040 40404040 



17171717 17171717 
3790ECD0 0CC5AC41 
40404040 40404C40 



O00OCC0O 0C255C5C 
3790ECDC 0CC5AC41 
40404040 404C4C40 
BUFFER 
PREFIX 
00150CC4 002510000 



D9D4E74C 05E8C340 
FCF84BF5 F34BF2F3 
♦♦UNKNOWN TRACE ENTRY TYPE** 



F440FCF8 4BF5F24B 
40C8C940 E30640E3 
LENGTH- 



F3F440C3 
C8C540E2 
0054 



C8C1D94C 
47404040 



E6C1E240 6140F240 
40404040 404C4C40 



E6C9E3C3 C8C5C44C E3C50904 C9D5C1D3 
17171737 CAB1E7C1 07011510 76E740D5 
C5D<=E84C 6140E3H6 40C1P3D3 4C63C5D9 



E2401517 17171717 17171717 17171717 
E8C340F5 40F0F84B F5F24BF4 F840C5E5 
T4C905C1 C0404040 40404040 40404040 



♦ 1050. S..* 

*.MINALS X NYC 2 8.51.53 MA* 

*RY HUYCK . HI TO THE. * 



*RMX NYC 3 C8.52.07 NYC . 2 08.52* 
*.10 HELLO TO ME * 



* 1050. S..* 

*.MINALS X NYC 2 08.51.53 MA* 

*RY HUYCK . HI TO.THEP * 



♦ RM....X X NYC 4 CH* 

*AR WAS . HI TO THE S. * 



♦WITCHED TERMINALS * 

*RMINALS X NYC 3 08.52.07 NY* 

*C . HELLO TO ME. .THE. * 



*...H * 

*RMX NYC 4 C8.52.34 CHAR WAS . 2 * 
*08.52.34 HI TO THE S. * 



♦ WITCHED TERMINALS * 

*.... TCAM RUNNING ♦ 

♦0 ♦ 



*... TCAM RUNNING 













♦RMX NYC 4 C8.52.34 CHAR WAS . 2 * 
♦08.53.23 HI TO THE S. ♦ 



♦WITCHED TERMINALS ♦ 

♦ X X NYC 5 08.52.48 EV^ 

♦ERY . TO ALL TERMINA. ♦ 



Figure 31. Log Segment Output 
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Using the Log Message Dump: Logging messages gives you an excellent data 
collection facility. Use it to provide a long-term backup for messages transmitted 
in your network for accounting. In Figure 32, the LOG macro is included in both 
the inmessage and outmessage subgroups. Since there are two destinations, there 
are three log entries for the message. It is difficult to tell the input message from 
the outgoing message, since the log entry is made before outgoing processing. 
However, the entries are sequential. You know that the first entry found for a 
message is the input message. TCAM makes an entry each time the message 
passes through the message handler. As with logged segments, entries are made in 
the order of processing, so there may be intermixed messages. 

Note: The unreadable data appearing in the message is the translation of the 
buffer prefix. 



rm x 

HITCHED TERMINALS 
RM X 

LS HED ERMINALS 
RM X 



X NYC 4 08.52.34 CHAR WAS / HI TO THE S 

X NYC 4 08.52.34 CHAR WAS / HI TO THE S 

X NYC 5 08.52.48 EVERY / TO ALL TERPINA 

(§)X NYC 4 8.52.34 CHAR WAS / HI TO THE S 

X NYC 5 08.52.48 EVERY / TO ALL TERMINA 



Figure 32. Log Message Output 



OBR/SDR File Dump 



A TCAM I/O error-recording facility creates records on disk when terminal- 
related I/O errors occur. This recording, an extension of the OS Outboard 
Recorder (OBR) and Statistical Data Recorder (SDR) error-recording programs, 
can be used to diagnose line and terminal problems and thus increase line availa- 
bility and efficiency. 

TCAM ordinarily keeps a certain amount of information about line and terminal 
behavior. If you suspect that a specific line or terminal is malfunctioning, you can 
increase the amount of information kept about the suspected terminal with 
intensive-mode recording. The operator command ERRECORD creates tempo- 
rary error (intensive mode) records for recoverable I/O errors occurring on a 
specified line or station. The format of the command is: 



control characters 


operation 


operand 


control chars 


(MODIFY) 


\ [procname.] id ), 
I job name ) 

INTENSE= (LINE,(grpname,rln)\sense, (count) 
) /address \\ tU ) 
(TERM.statname j 



where 



grpname is the name of the line group containing the line for which incident 
records are desired. 

rln is the relative line number of the line within the group. 

address is the machine address of the line. 

statname is the name of the station for which incident records are desired. 



TCAM Diagnostic Aids 101 



sense is the type of intensive recording desired. You can select 

BO bus-out check 

CR command reject 

DC data check 

EC equipment check 

IM general intensive mode 

IR intervention required 

LD lost data 

M2 leading graphics for 2740 Model 2 terminal 

OR overrun 

TO time-out 

UE unit exception 

count is the decimal number of records for the incident type. The maximum 
and the default are 15. 

If you do not use intensive mode, recoverable errors for a station or line are not 
recorded, but an internal counter is incremented by one. The command 

OPID F JOBNAME,INTENSE=TERM,NYC,TO, 12 

entered from a secondary terminal specifies that you want an error recording on 
disk for the station named NYC in the job JOBNAME whenever there is a 
time-out, up to a maximum of 12 records. 

The OS utility, IFCEREPO, retrieves the error recordings from disk, dumps them, 
and formats them. The recordings are maintained in the SYS1.LOGREC data set. 
The sample JCL below formats the data set, prints it (both individual and summa- 
ry records for each terminal), and scratches the OBR/SDR file. 

//OBRSDR JOB MSGLEVEL=1 

//STEP EXEC PGM=IFCEREP0,PARM=(MCOS,PS ) 

//SERLOG DD DSNAME=SYS1 . LOGREC , DISP=OLD, VOL=SER=SYSRES , * 

// UNIT=2314 

//EREPPT DD UNIT=00E 

/* 

The TERMN= option in the PARM= parameter allows you to dump your 

SYS1. LOGREC data by terminal name. Seethe OS Utilities publication for a 

complete description of the PARM= parameter and the control statements. 

You should consider several things when running IFCEREPO. First, since this 
data set is not reusable and does not wrap around, it will have to be reinitialized 
when it fills up or on some periodic schedule. IFCEREPO reinitializes the data set 
as it dumps. Second, you should code the parameter PS to ensure that all records 
and summaries are written. PS is the default. You will generally be more interest- 
ed in the summary records than in the individual records. Finally, if you use 
SYSOUT=A rather than allocating directly to the output device, code a SPACE= 
parameter, since the OBR/SDR file is fairly large. 

Dump the OBR/SDR file whenever you have a problem that seems to be caused 
by a malfunctioning line or station, such as lost data or lost line. You should also 
dump the file at the end of the day, to keep yourself aware of the hardware status 
of your network. In addition, once the SYS1. LOGREC data set is full, it is very 
time-consuming to dump. 

OBR/SDR Table: TCAM I/O error recording writes certain terminal-related I/O 
errors on disk. This recording, an extension of the OS Outboard Recorder (OBR) 
and Statistical Data Recorder (SDR) programs, reduces the time that the TCAM 
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system is inoperative by providing useful information for diagnosing line and 
terminal problems. 

Four types of I/O error records are written in the data set: 

1. Permanent error record. Written for each permanent I/O error. A permanent 
I/O error is either an unrecoverable error (an undefined, unanticipated I/O 
error for which TCAM provides no error-recovery procedure), or an I/O error 
for which TCAM provides an error-recovery procedure, but which TCAM has 
tried several times to correct and failed each time. 

2. Temporary error record. Written whenever an error occurs for a particular line 
or station specified by an ERRECORD operator command, if TCAM success- 
fully recovers from the error. 

3. Counter overflow record. Written when either the SIO counter (the number of 
start I/O commands issued) or the temporary error counter for a particular 
terminal-table entry is about to overflow. 

4. End-of-day record. Written for each station and line in the line group that has a 
terminal entry and a nonzero temporary error counter. 

The OS utility program IFCEREPO prints a formatted dump of these error records 
from the data set SYS1.LOGREC. The following sections discuss the output that 
you can use to determine problems. 

I/O Device (Outboard) Records: TCAM produces and stores these records for 
permanent device errors. TCAM terminal statistics and errors are outboard 
records. Two types of recording mode are possible for an outboard record: 

1. Unrecoverable. A record of a permanent I/O error. See the description of a 
permanent error above. 

2. Intensified. A temporary error record which is described above. 

Figures 33 and 34 are examples of an unrecoverable and an intensified error 
record, respectively. Each has the same formatted data. The meaning of each 
field follows. The command issued to get the intensified I/O error record was: 

f linkgo,INTENSE=TERM,NYC,TO, 15 
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PROGRAM SECTION: 



TCAM OUTBOARD DATA EDITING AND PRINTING SECTION 
MODEL-UNIVERSAL 



— RECORD ENTRY SOURCE - OBR — 
CHANNEL/UNIT ADDRESS 0018 



TYPE - OUTBOARD 
DEVICE TYPE 2702 



COMMUNICATION ADAPTER TYPE IBM TERM 1 
TERMINAL TYPE IBM 2740 



PROGRAM IDENTITY LINKGO 



DATE 



DAY 
210 



YEAR 
71 



HH 
TIME - 00 



MM SS TH 
16 09.35 



FIRST CCW 
FAILING CCW 



CSW 



COMMAND 
CODE (CC) 
01 
01 



KEY(K) 
00 



DATA 
ADDRESS (DA) 
03492 D 
03492 D 

COMMAND 



FLAGS (FL) 
60 
60 

UNIT 



ADDRESS (CA) STATUS (US) 
072118 0E 



00 
00 

CHANNEL 
STATUS (CS) 
00 



COUNT(CT) 
0003 
0003 



COUNT (CT) 
0003 



J 



UNIT STATUS 

ATTENTION 

STATUS MODIFIER 

CONTROL UNIT END 

BUSY 

CHANNEL END 1 

DEVICE END 1 

UNIT CHECK 1 

UNIT EXCEPTION 



J 



CHANNEL STATUS 
PRGM-CTLD IRPT 
INCORRECT LENGTH 
PROGRAM CHECK 
PROTECTION CHECK 
CHAN DATA CHECK 
CHAN CTL CHECK 
l/F CTL CHECK 
CHAINING CHECK 



SENSE BYTE DATA 
INITIAL FAILURE 
BYTE 

CMND REJ 
INTV REQD 
BUS O CHK 
EQUIP CHK 
DATA CHK 
OVERRUN 
LOST DATA 
TIME-OUT 



01 000000 


1 










TERMINAL NAME NYC 
SIO CNTR 00006 
MASK 00000000 



FINAL RETRY 




BYTE0 


01000000 


CMND REJ 





INTV REQD 


1 


BUS O CHK 





EQUIP CHK 





DATA CHK 





OVERRUN 





LOST DATA 





TIME-OUT 






RECORDING MODE *UN RECOVERABLE* 
TEMPORARY ERR CNTR 000 
INITIAL SELECTION 



Figure 33. An Unrecoverable I/O Error Record 
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PROGRAM SECTION: 

TCAM OUTBOARD DATA EDITING AND PRINTING SECTION 

MODEL-UNIVERSAL 

— RECORD ENTRY SOURCE - OBR — TYPE - OUTBOARD 

CHANNEL/UNIT ADDRESS 002C DEVICE TYPE 2703 

COMMUNICATION ADAPTER TYPE IBM TERM 1 
TERMINAL TYPE IBM 2740 

PROGRAM IDENTITY LINKGO 



DAY YEAR 








HH MM 


SS TH 






DATE - 211 71 








TIME - 07 17 


55.13 






COMMAND 




DATA 












CODE 




ADDRESS 


FLAGS 






COUNT 


FIRST CCW 


01 




03492 D 


60 


00 




0003 


FAILING CCW 


02 




065C01 


80 


00 




0002 






COMMAND 


UNIT 


CHANNEL 






KEY 




ADDRESS 


STATUS 


STATUS 




COUNT 


CSW 


00 




065190 


0E 


40 

J 




0001 


UNIT STATUS * 






CHANNEL STATU 




ATTENTION 









PRGM-CTLD IRPT 







STATUS MODIFIER 







INCORRECT LENGTH 


1 




CONTROL UNIT END 







PROGRAM CHECK 







BUSY 









PROTECTION CHECK 







CHANNEL END 


1 




CHAN DATA CHECK 







DEVICE END 




1 




CHAN CTL CHECK 







UNIT CHECK 




1 




l/F CTL CHECK 









UNIT EXCEPTION 







CHAINING CHECK 







SENSE BYTE DATA 
















INITIAL FAILURE 








FINAL RETRY 








BYTE 00000001 






BYTE 00000000 






■CMND REJ 









CMND REJ 









INTV REQD 









INTV REQD 









BUS O CHK 









BUS O CHK 









EQUIP CHK 









EQUIP CHK 









DATA CHK 









DATA CHK 









OVERRUN 









OVERRUN 









LOST DATA 









LOST DATA 









TIME-OUT 


1 






TIME-OUT 










TERMINAL NAME NYC 
SIO CNTR 00222 
MASK 00011110 



RECORDING MODE INTENSIFIED* 
TEMPORARY ERR CNTR 001 
INITIAL SELECTION 



Figure 34. An Intensified I/O Error Record 



TCAM Diagnostic Aids 105 



Program section: The program section that is generating the printout. 

Model: The IBM System/360 model for which the printout is applicable. In 
this example, UNIVERSAL indicates that the printout is applicable to models 
40, 50, 65, 67, 75, 85, 91, and 195. 

Record entry source: The error environment or recovery management program 
that generated the record in the SYS1.LOGREC data set. 

Type: The type of printout. 

Channel /Unit address: The hardware address of the line on which the error 
occurred or on which the terminal in error is located. 

Device: The transmission control unit being used. 

Program identity: The name of the job that was active when the error occur- 
red. 

Date time: The date and time at which the error occurred. The day is the 
Julian calendar date and the hour is in continental (24-hour) time. 

First CCW: The first executed channel command word (CCW) in the channel 
program. 

Failing CCW: The channel command word that failed to execute. 

CSW: The channel status word when the failure occurred. 

Sense byte data: For a description of the contents of the sense byte, see the 
component description publication for the transmission control unit that you 
are using. 

Terminal name: The name of the terminal on which the error occurred. This is 
the name you assigned in the TERMINAL macro. 

Recording mode: The type of error recording. It is either unrecoverable or 
intensified. 

SIO cntr: The start I/O counter, a count of the number of EXCPs issued for 
the line before the error occurred. It is reset to zero each time an entry is made 
in the SYS 1 .LOGREC data set. 

Temporary err cntr: A count of the number of temporary I/O errors that 
occurred for the terminal since the last record was made. It is reset to zero 
each time an entry is made in the SYS1. LOGREC data set. 

Mask: An eight-bit field that is used if you issue the ERRECORD operator 
command. The first four bits indicate the type of error for which the terminal 
was intensified. 

Bits Meaning 

0001 time-out 

0010 lost data 

0011 overrun 
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0100 data check 

0101 equipment check 

0110 bus-out check 

0111 intervention required 

1000 command reject 

1001 unit exception 

1010 leading graphics for 2740 Model 2 terminals 

The last four bits indicate the number of error recordings yet to take place. 
The original value is specified in the command and decremented by one for 
each recording made. 

Initial selection: Set to 1 if an error occurs on the first attempt to contact the 
control unit. 

Examine this error record after you suspect that you have trouble on a line or 
terminal. You can determine the reliability of your line by comparing the number 
of start I/Os to the number of temporary errors. Once you know there is trouble 
on the line, the CCW helps you determine which activity was failing to execute. 
This can lead you to the hardware feature that is failing. 

Summary of Outboard Records: You can find valuable information in the summary 
of TCAM I/O outboard records for each line in your network. By examining this 
output, you can determine the reliability of the line and of terminals on the line. If 
you see that a line is continually failing with permanent errors, then look at the 
individual outboard record for the terminal to pinpoint the failure. Examine the 
summary output for each of your lines daily, to remain aware of the status of your 
network. Take a summary listing of each line as soon as your TCAM system is 
operating to your satisfaction, and use it as a base for examining the line reliabili- 
ty. By comparing each day's summary to this base summary, you can see if your 
line and terminal reliability has decreased. 

Figure 35 shows a summary output for the line address 011 on a 2702 control 
unit. The ratio of unrecoverable errors to start I/Os (30 to 165) is relatively low, 
indicating that the line is reasonably reliable. However, you should keep a watch- 
ful eye on this line, since the majority of the permanent errors occurred on the 
same operation, time-out on read next text. 

If you have more than one terminal on a line, the summary output gives informa- 
tion about each terminal, with a total summary of the line. Figure 36 shows the 
output for line address 022 on a 2703 control unit with two stations located on the 
line. There is no question about the reliability of this line or the terminals on the 
line, since the unrecoverable error to start I/O ratio is extremely low (2 to 128 for 
the line, 1 to 44 for the terminal CHAR, and 1 to 84 for the terminal WAS). 

Figure 37 shows an entry for a terminal that was placed in intensified mode by the 
ERRECORD operator command. There were two unrecoverable errors of 380 
start I/Os before intensification began. After the command was issued, 265 start 
I/Os occurred and 2 temporary errors for which the terminal was intensified 
occurred. The error-to-start I/O ratio is extremely low in both cases, indicating a 
very reliable line and terminal. 



End-of-Day Recording: You get an end-of-day recording for each station that was 
active and had errors (nonzero temporary error counter). It is not a summary of 
the station activity; it simply indicates what occurred on the station since the last 
error record entry was made in SYS1.LOGREC. Figure 38 shows an end-of-day 
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DAY YEAR DAY YEAR 
OUT BOARD DATE RANGE -204 71 TO 204 71 
SUMMARY OF TCAM I/O OUTBOARD RECORDS FOR CUA/LINE 0011 
TOTAL NUMBER OF RECORDS 0030 



DEVICE TYPE 2702 



TOTAL NUMBER OF SIO'S 0165 

TOTAL NUMBER OF TEMPORARY FAILURES 0002 



TOTAL NUMBER OF UNRECOVERABLE (UNREC) ERRORS 0030 
TOTAL NUMBER OF INTENSIVE MODE (INTEN) ERRORS 0000 





ERROR TYPES 


TOTL 
SIOS 


TOTL 
TEMP 
ERR 


TOTL 
PERM 
ERR 


LOST 
DATA 


COMD 
REJ 


COMD 
REJ 


UNIT 
XCPT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


INTR 
REQ 


OVER 
RUN 


BUSO 
CHK 


BUSO 
CHK 


BUSO 
CHK 


DATA 
CHK 


DATA 
CHK 


DATA 
CHK 


EQPT 
CHK 




CONDITION 








ALL 


INIT 
SEL 


OTHR 


ALL 


PRE 
PARE 


READ 
NTXT 


DIAL 


OTHR 


ALL 


ALL 


WRIT 


DIAL 


OTHR 


WRIT 


READ 


OTHER 


ALL 




2740-11 
GRAPHIC RESP 








TE 
EL 
ER 


*M 
EC 


TE 

l/< 
ER 


D 


REC 

PARITY 

ERR 


TRANS 
PARITY 
ERR 




















TERMINAL 
NAME 


RECORD 
MODE 


RAL 




UNREC 


0165 


0002 


0030 


0001 










0028 






0001 






















INTEN 











































Note: In this and the following two examples, the solid lines have been added for clarity. 
They are not part of the output from IFCEREP0. 
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DAY YEAR DAY YEAR 
OUT BOARD DATE RANGE -211 71 TO 211 71 

SUMMARY OF TCAM I/O OUTBOARD RECORDS FOR CUA/LINE 0022 DEVICE TYPE 2703 

TOTAL NUMBER OF RECORDS 0002 



TOTAL NUMBER OF SIO'S 0128 

TOTAL NUMBER OF TEMPORARY FAILURES 0002 



TOTAL NUMBER OF UNRECOVERABLE (UNREC) 
TOTAL NUMBER OF INTENSIVE MODE (INTEN) 



ERRORS 0002 
ERRORS 0000 





ERROR TYPES 


TOTL 
SIOS 


TOTL 
TEMP 
ERR 


TOTL 
PERM 
ERR 


LOST 
DATA 


COMD 
REJ 


COMD 
REJ 


UNIT 
XCPT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


INTR 
REQ 


OVER 
RUN 


BUSO 
CHK 


BUSO 
CHK 


BUSO 
CHK 


DATA 
CHK 


DATA 
CHK 


DATA 
CHK 


EQPT 
CHK 




CONDITION 








ALL 


INIT 

SEL 


OTHR 


ALL 


PRE 
PARE 


READ 
NTXT 


DIAL 


OTHR 


ALL 


ALL 


WRIT 


DIAL 


OTHR 


WRIT 


READ 


OTHR 


ALL 




2740-11 
GRAPHIC RESP 








TE 
EL 
ER 


?M 

EC 
R 


TE 

l/< 
ER 


?M 
D 


REC 
PAR 
ERR 


ITY 


TRA 
PAR 
ERR 


NS 
ITY 




















TERMINAL 
NAME 


RECORD 
MODE 


CHAR 


UNREC 


0044 


0001 


0001 












0001 
























INTEN 












































UNREC 


0084 


0001 


0001 












0001 




























INTEN 











































Figure 36. A Summary Outboard Record for an Unrecoverable I/O Error 

entry. The fields have the same meaning as those in the individual outboard 
records. However, the program identity is not available, since you have removed 
TCAM from your system. 

The outboard records (OBR) can be a valuable tool to determine problems, 
because it keeps you aware of line and terminal status. The statistical data records 
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DAY YEAR DAY YEAR 
OUTBOARD DATE RANGE-211 71 TO 211 71 
SUMMARY OF TCAM I/O OUTBOARD RECORDS FOR CUA/LINE 0020 
TOTAL NUMBER OF RECORDS 0004 

TOTAL NUMBER OF SIO'S 0645 

TOTAL NUMBER OF TEMPORARY FAILURES 0002 



DEVICE TYPE 2703 



TOTAL NUMBER OF UNRECOVERABLE (UNREC) ERRORS 0002 
TOTAL NUMBER OF INTENSIVE MODE (INTEN) ERRORS 0002 





ERROR TYPES 


TOTL 
SIOS 


TOTL 

TEMP 
ERR 


TOTL 
PERM 
ERR 


LOST 
DATA 


COMD 
REJ 


COMD 
REJ 


UNIT 
XCPT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


TIME 
OUT 


INTR 
REQ 


OVER 
RUN 


BUSO 
CHK 


BUSO 
CHK 


BUSO 
CHK 


DATA 
CHK 


DATA 
CHK 


DATA 
CHK 


EQPT 
CHK 




CONDITION 








ALL 


INIT 
SEl 


OTHR 


ALL 


PRE 
PARE 


READ 
NTXT 


DIAL 


OTHR 


ALL 


ALL 


WRIT 


DIAL 


OTHR 


WRIT 


READ 


OTHEF 


ALL 




2740-11 
GRAPHIC RESP 








TE 
EL 
ER 


EC 


TERM 

I/O 

ERR 


REC 

PARITY 

ERR 


TRANS 
PARITY 
ERR 




















TERMINAL 
NAME 


RECORD 
MODE 


NY r 


UNREC 


0380 




0002 












0002 




























INTEN 


0265 


0002 







































TCAM Libraries Dump 



Figure 37. A Summary Outboard Record for an Intensified I/O Error 

TCAM OUTBOARD DATA EDITING AND PRINTING SECTION 

MODEL-UNIVERSAL 

— RECORD ENTRY SOURCE - OBR — TYPE - OUTBOARD 

CHANNEL/UNIT ADDRESS 001 E DEVICE TYPE 2701 

COMMUNICATION ADAPTER TYPE IBM TERM 1 
TERMINAL TYPE IBM 2740 



PROGRAM IDENTITY NOT AVAILABLE 

DAY YEAR 
DATE - 196 71 

TERMINAL NAME BBB 

SIO CNTR 00025 

MASK 00000000 

Figure 38. An End of Day Record 



HH MM SS TH 
TIME - 00 13 53.13 

RECORDING MODE *END OF DAY* 

TEMPORARY ERR CNTR 001 

INITIAL SELECTION 



(SDR) are not as valuable to you in a TCAM environment, since they contain 
temporary error records for devices other than lines or terminals, such as tapes 
and disks (not discussed in this manual). 



You should always have a listing of your TCAM and system base and PTF level 
available. You must have this listing for all problems that require IBM assistance. 
An OS service aid program, IMAPTFLS, prints this listing. The following sample 
JCL lists all members in the named libraries. Applied PTFs and local fixes are 
listed with the associated module. 



//JOBLIST 

//STEP 

//LISTREST 



JOB MSGLEVEL=1 
EXEC PGM=IMAPTFLS 
DD DUMMY 
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Service Aids 



Dumping TCAM Trace Tables 



Printing Trace Table Dumps 



//SVCDD 


DD 


//MACDD 


DD 


//LINKDD 


DD 


//TCAMDD 


DD 


//SYSPRINT 


DD 


/* 





DSNAME=SYS1 . SVCLIB , DISP=SHR 
DSNAME=SYS1 . MACLIB, DISP=SHR 
DSNAME=SYS1 . LINKLIB, DISP=SHR 
DSNAME=SYS1 . TELCMLIB, DISP=SHR 
SYSOUT=A 



All names on the DD statements are optional except LISTREST. See OS Service 
Aids for a complete description of the IMAPTFLS programs. 



You can use the four optional TCAM service aids for diagnosing problems. These 
are the line I/O interrupt trace table, the subtask trace table, the buffer trace, and 
the cross-reference table. These trace facilities record valuable data about 
TCAM, and in the case of a malfunction, they can be very useful during the 
testing and diagnostic stage. You should include them in your system. See the 
following sections, and the TCAM Programmer's Guide, to learn how to include 
and use these facilities in your system. 



A TCAM routine, named COMWRITE, writes the I/O interrupt trace, the 
subtask trace, and the buffer trace tables onto a sequential data set named COM- 
WRITE. To use this routine, you must include either at assembly time or at 
INTRO execution time the INTRO operand COMWRTE=YES. COMWRITE is 
required, in order to see a total picture of the system activity before and after TP 
failures, since it provides a complete history of system activity. 

For the I/O and subtask traces, if you did not specify COMWRTE=YES on the 
INTRO macro, the table in main storage wraps around after it is filled. So, with 
COMWRTE=YES, you can have a smaller trace table, requiring less main stor- 
age, with little fear of losing entries. 

Each trace is most commonly written to tape. There are three reasons for using a 
tape as the trace data set. First, you can dump the trace selectively by time. 
Second, you can have a large trace table. If your data set is on a direct access 
device, you must be sure that 1/2 n( 16) + 16, where n is the total number of 
entries in your trace table, is less than the byte capacity of one track. A tape 
supports large records; therefore, there is little worry about the trace-table size. 
Third, once your data set on disk is full, the data set wraps around and you are apt 
to lose trace-table entries as they are overlaid. Since you must have a very large 
data set to avoid wrapping, it is more economical to have your data set on tape. 



If the COMWRITE routine has been used to dump the trace tables to secondary 
storage, the utility program to format and print these trace tables is COMEDIT 
(IEDQXB). An example of the JCL to print the trace from an unlabeled tape 
follows; the data set named COMWRITE on the SYSUT1 statement is the name 
of the DD statement in the MCP execution deck that created the COMWRITE 
data set. 



//PRINT 

//STEP 

//SYSPRINT 

//SYSUT1 

// 

/* 



JOB MSGLEVEL=1 
EXEC PGM=IEDQXB,PARM='xxxx' 
DD SYSOUT=A 

DD DSN=COMWRITE , UNIT=2400 , DISP=OLD , * 
LABEL=( ,NL) , VOL=SER=DUMMY 
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Replace xxxx in the EXEC statement with IOTR to print the I/O trace, with 
STCB to print the subtask trace, and with BUFF to print the buffer trace. If you 
omit the PARM= parameter, all three traces are printed. 

Another parameter on the EXEC statement prints the trace-table entries starting 
at a specified time. For example, if a problem occurs after 3:00 on a certain day, 
you can print the trace from 3:00 on. The parameter is 

BLOCK=hhmmddd 

where hh represents the hours in continental (24-hour) time, mm is the minutes 
(60 minutes to an hour), and ddd is the Julian date (January 1 is 001, etc.). The 
following EXEC statement prints the subtask-trace table entries that occur after 
2:15 p.m. on January 8: 

//EXEC PGM=IEDQXB,PARM=' STCB, BLOCK=1 4 15008' 

Always include a small trace table (relative to the number of lines in your net- 
work) in your MCP. 



Line I/O Interrupt Trace Table 



This TCAM service aid sequentially records the I/O interrupts that occur on a 
specified line. When an I/O interrupt occurs on a line for which you requested 
line I/O trace, TCAM stores information about the interrupt, including the 
channel status word (CSW) and channel command word (CCW), as an entry in 
the line I/O interrupt trace table. However, TCAM does not record interrupts 
resulting from retries by error-recovery procedures. 

Activating the Trace: Whether this trace is available in main storage depends on 
how you design your MCP. To include it, code on the INTRO macro instruction 
the operand TRACE=n, where n is an integer from 1 to 65535 that specifies the 
number of entries in the table. The default, TRACE=0, excludes the table. You 
can include the operand at assembly time, or at INTRO execution time in response 
to the message 

IED002A SPECIFY TCAM PARAMETERS 

that you receive only if you omit one of the following INTRO operands at assem- 
bly time: 

STARTUP=, LNUNITS=, KEYLEN=, and, if DISK=YES, CPB= 

The response keyword is T=n or TRACE=n. 

Start and stop the I/O interrupt trace for a line with the GOTRACE and NOT- 
RACE operator commands, respectively. Their formats are: 



GOTRACE: 



control characters 


operation 


operand 


control chars 


/modify) 


/[procname.]id),TRACE=/grpname,rlnl ,ON 
(jobname / (address ; 


NOTRACE: 


control characters 


operation 


operand 


control chars 


/modify) 


/[procname.]id\ ,TRACE=/grpname,rln\,OFF 
(jobname ) \address ) 
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where 

grpname is the name of the line group and is identical to the DDNAME= 
operand of the DCB macro instruction for the line group for which you enter 
the command. 

rln is the relative line number of the. line within the line group. 

address is the hardware address of the line and is identical to the UNIT= 
operand of the DD statement for the line for which you enter the command. 

Example: F GOTCAM,TRACE=022,ON is the command from the system 
console to start the I/O trace on the line whose address is 022 in the job named 
GOTCAM. The command F GOTCAM,TRACE=022,OFF stops the trace on 
line 022. 

Start the line traces one at a time. You cannot enter multiple addresses in the 
trace parameter. 

The trace table resides in main storage allocated to the MCP and, therefore, to get 
a copy of the table, you must dump your MCP. See COMEDIT in the TCAM 
Programmer's Guide. 

If you wish to dump the I/O trace table to a sequential data set to provide a 
history of I/O activity, you must activate the COMWRITE routine for the I/O 
trace table dump by issuing the DEBUG operator command. 



control characters 



operation 



operand 



control chars 



(MODIFY 



n 



[procname.]id\ 
jobname j 



,DEBUG=L,IEDQFE20 



Note: COMWRTE=YES must have been specified either at assembly time or 
INTRO execution time. 

This loads (L) the dump routine for I/O trace. If you want to deactivate the 
routine, replace the L with D; otherwise, the command is the same. The routine 
prints half of the table at a time to the sequential data set while the other half in 
main storage is being filled. Therefore, your most current entries in the trace table 
are still in main storage. 

Example: Printing the line I/O trace table when COMWRITE is used. 



JOB MSGLEVEL=1 
EXEC PGM=IEDQXB,PARM='IOTR' 
DD SYSOUT=A 

DD DSN=COMWRITE , UNIT=2400 , DISP=OLD , 
LABEL=( ,NL),VOL=SER=DUMMY 



//PRINT 

//STEP 

//SYSPRINT 

//SYSUT1 

// 

/* 

The I/O trace table is also printed if no PARM= parameter is specified on the 
EXEC statement. 

The line I/O trace is most important for all line-oriented problems. Start the trace 
for a particular line as soon as you detect trouble on the line (lost or bad data or 
lost line), and then dump it. 
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Using the Line I/O Interrupt Trace: The TCAM line I/O interrupt trace table 
records I/O interrupts occurring on specified lines. Interrupts that result from 
retries by TCAM error-recovery procedures are not recorded. 

Use this table to determine problems at a station. By examining the first channel 
command word (CCW), the interrupt CCW, and the channel status word (CSW), 
you can determine which channel program was executing on the line, and possibly 
determine whether the station or data set is in error. 

The Table in Main Storage: If you specify a nonzero value for TRACE= in the 
INTRO macro, the trace table is located in main storage; its address is at 
AVT+X'174'. Figure 39 shows the line I/O interrupt trace table format. 



AVT 



+ X'174' 



I 



FORMAT OF THE I/O INTERRUPT TRACE TABLE CONTROL BLOCK 





BYTE 


EXPLANATION 





ADDRESS OF CURRENT TRACE ENTRY 
i 1 1 


+4 


ADDRESS OF FIRST TRACE ENTRY 

1 1 1 


+8 


ADDRESS OF LAST TRACE ENTRY 

i l 1 


+ 12 


ADDRESS OF MIDDLE ENTRY 

i I I 



BYTE: 


+8 

+16 

+24 



FORMAT OF AN I/O INTERRUPT TRACE TABLE ENTRY 



SENSE 
BYTE 


+1 


CSW 




INTERRUPT CCW 


+13 


TP OP CODE OF 
INTERRUPTED CCW 


FIRST CCW IN 

CHANNEL PROGRAM CHAIN 


+21 


TP OP CODE OF 
FIRST CCW 


STATION NAME 


+30 CHANNEL AND 
UNIT ADDRESS 



Figure 39. Line I/O Interrupt Trace Table Format 

The meaning of each field in the entry follows. 

Sense byte: For a description of this byte, see the component description 
publication for the transmission control unit that you are using. 

CSW: The channel status word. The entry contains the last seven bytes of the 
CSW, which has the following format. 
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COMMAND 
ADDRESS 


STATUS 


COUNT 



32 



48 



63 



Command address: Bits 8 to 31 form an address that is eight 
bytes higher than the address of the last CCW used. 

Status: Bits. 32 to 47 identify the reasons why the CSW was 
stored. 

Bits 32 to 39 are obtained over the I/O interface and are set by the 
device or the control unit. 

Bits 40 to 47 are set by the channel for conditions in the subchannel. 
Each of the 16 bits indicates a condition. 



Bit 


Condition 


Bit 


Condition 


32 


attention 


40 


program-controlled 
interruption 


33 


status modifier 


41 


incorrect length 


34 


control unit end 


42 


program check 


35 


busy 


43 


protection check 


36 


channel end 


44 


channel data check 


37 


device end 


45 


channel control check 


38 


unit check 


46 


interface control check 


39 


unit exception 


47 


chaining check 



Count: Bits 48 to 63 form the residual count of the last CCW used. 

CCW: The channel command word. It is 64 bits (8 bytes) and has the follow- 
ing format. 



COMMAND 
CODE 


DATA 
ADDRESS 


FLAGS 


COUNT 







32 



37 48 



63 



Command code: Bits to 7 specify what is to be done. An X indicates that the 
bit position is ignored; an M is a modifier bit. 



Bits 

XXXX0000 

MMMM0100 

XXXX1000 

MMMM1100 

MMMMMM01 

MMMMMM10 

MMMMMM11 



Meaning 

invalid 

sense 

transfer in channel (TIC) 

read backward 

write 

read 

control 
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Data address: Bits 8 to 31 specify the address of a byte in main storage; it is 
the first location referred to in the area designated by the CCW. 

Flags: 

Bit 32: Chain data (CD) flag. When on, specifies data chaining, causing 
the storage area designated in the next CCW to be used with the current 
command. 

Bit 33: Chain command (CC) flag. When on and the CD flag is off, it 
specifies chaining of commands, so that the command specified in the 
next CCW is initiated when the current operation completes normally. 

Bit 34: Suppress length indication (SLI) flag. It specifies whether an 
incorrect length is indicated to the program. When this bit is on and the 
CD flag is off in the last CCW used, the incorrect length indication is 
suppressed. When both the CC and SLI flags are on, command chaining 
takes place regardless of the presence of an incorrect length condition. 

Bit 35: Skip (SKIP) flag. It specifies that the transfer of information to 
storage during a read, read backward, or sense operation is to be sup- 
pressed. 

Bit 36: Program controlled interruption (PCI) flag. If on, the channel 
generates an interrupt when the CCW takes control of the channel. 

Count: Bits 48 to 63 specify the number of byte locations in the storage 
area designated by the CCW. 

See Principles of Operation, GA22-6821, for a detailed discussion of the CCW 
and CSW. 

Teleprocessing Operation (TP OP) Code: A TP OP code with an even-numbered 
value represents a text or nontext CCW for which an interrupt is anticipated. A 
TP OP code with an odd-numbered value represents a CCW for which no inter- 
rupt is anticipated. TP OP codes are shown in Figure 40. 
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Name 


Value 


Description 


TPWREOT 


X'OT 


Write EOT for selection 


TPOPEN 


X'02' 


Open 


TPWRPOLL 


X'03' 


Write Polling Characters 


TPRDRESP 


X'04' 


Read Response to Polling 


TPWRPAD 


X'05' 


Write pad characters 


TPENABLE 


X'06' 


Enable on Dial Line 


TPWRAD 


X'07' 


Write Addressing Sequence 


TPRDRSPD 


X'08' 


Read Response to Addressing 


TPWREOA 


X'09' 


Write EOA Sequence 


TPRDRPEB 


X'OA' 


Read Response to EOB/ETB 


TPWRCPU 


X'OB' 


Write CPU ID 


TPRDENQ 


X'OC 


Read ENQ 


TPWRENQ 


X'OD' 


Write ENQ 


TPRSPENQ 


X'OE' 


Read Response to ENQ 


TPWRDLET 


X'OF' 


Write DLE EOT 


TPRDID 


X'10' 


Read ID (TSO) 


TPNULL 


x'lr 


Non-Read Write CCWs for which no 
Interrupt is anticipated 


TPBREAK 


X'12' 


Write BREAK (TSO) 


TPENQAD 


X*13' 


Write ENQ after Selection Response 


TPRDLC 


X'14* 


Read LCOUT 


TPWRACK 


X'15' 


Write Response Before Text 


TPWRAKNK 


X'16' 


Write Response 


TPWRTONE 


X'17' 


Write Tone (WTTA BSC) 


TPRDIDNQ 


X'18' 


BSCRead ID ENQ 


TPRDIDAK 


X'lA' 


BSC Read ID ACK 


TPRESET 


X'lC 


Abort for Send/Receive 


TPTWXID 


X'lE' 


Read TWX ID 


TPBUFEOT 


X'20' 


Buffered Terminal Reset after Block 


TPCLOSE 


X'22' 


Close SDR Recording 


TPRSPAD 


X*24' 


Write Reset after Selection 


TPRDSKIP 


X'51 1 


Read Skip Loop 


TPWRIDLE 


X'53' 


Write Idles Loop 


TPDLESTX 


X^V 


Write DLE STX 


TPDLEETX 


X'59' 


Write DLE ETB (ETX) 


TPENQRSP 


X'5B' 


Write ENQ in Response to Text 


TPTEXT 


X'FF' 


Text CCW 



Figure 40. TCAM TP OP Codes 

Station name: The name of the terminal on which the interrupt occurs. 

Channel and unit address: The channel and unit address of the connected station 
when the interrupt occurs. 

Part 1 of Figure 41 illustrates the four-word control section for the trace table 
generated when TRACE=100 was coded in the INTRO macro. 

Part 2 of Figure 41 shows an interrupt on a 2740 Model 2 station named MARY. 
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AVT 



"1 



+ 372 (174) 



069370 



JT 



069340 01039S31 A0000001 01039933 AOOOOOOF 

069360 OCOCOOOO 00000000 OCOOOOOO 00000000 

069380 0006CA68 OD40004F 02060A6C A0000054 

0693A0 0CC6A318 00000001 0606A2CSTART OF 

0693C0 0006A250 CD000001 0606A2lTRACE TABLE 

0693E0 0CC6CCC8 CC000001 C 106DDCC 20000016 

069400 0C06E488 0C0OOOO1 0106E48C 20000016 




(CURRENT qc FIRST q Qq LAST ^q q MIDDLE q * 

00069820 00069380 00069FEO C00699C0 * 

) * HUYCK 

0103992C 60"'"""-''"5Yct?An 40400C17 * R DUR 

01039920 6oSr?Irr L -?55JI 1 ?!; 40400012 * atl 

0103992C A0010003 C4E40940 40400017 *...H OUR 

01039920 A0010003 C1E3D340 40400012 *..U U ATL 



069600 
069620 



00C6CCA8C C 4 1 '"" 



069640 |0C|C77110 CC4000C8| 207700C QC|08|0009| 



Figure 41. The Line I/O Inlemipl Trace Table in Main Storage (Pari I of 2) 



FIRST CCW 
0206h^"m ^ouum0009 C1E3D340 40400012 * ATL 

f ^C4E4D940 40400C17 ♦ OUR 

I0103992C 60|01J0003| D4C109E8 404O|0C15| » HARY| 

0206A224 6' T P0P>9 ClE STAT | ON 't04. C HANNEL * ATL 

0206A2EC 6icODE ' 9 C * E NAME i04 AND UNIT* DUR 

01039931 80090001 D4ClUVbH 404i AnnRFS - *. . .Y MARY 

020770DC 600A0009 D4C1D9E8 404uvXr A " a -*...Y MARY 

0103992D 60010003 C8E4E8C3 02400015 * HUYCK 



069660sENSE D6DEe CSW^OOOOO 0106DBC0 0C TP P' 1 
069680BYTE 06CCA8 CC400000 0106DCE0 0C C0DE )1 
0696A0 0CC6CBE8 CC000001 01060BEC 20OUUIU6 
0696CC 0C06CEE8 CC400000 0106DC01 OOOOCOO 1 
0696E0 00077110 CC400008 020770DC 00080009 



Figure 41. The Line I/O Interrupt Trace Table in Main Storage (Part 2 of 2) 



1. There is no sense information for the 2702 control unit. 

2. The CSW 
command address is 771 10. Therefore, the last CCW used storage at 77108. 
status is 0C40. This is channel end, device end, and incorrect length, 
count is 8. The residual count is 8 for the last CCW. 

The interrupt CCW 

command code is 02. This is a read. 

data address is 0770DC. 

has no flags set. 

TP OP code is 08. This is a read response. 

count is 9. 

Therefore, the channel program was interrupted when reading the 9-byte response 
found at storage location 0770DC. 

4. The first CCW 
command code is 1 . This is a write, 
data address is 03992D. 

flags specify chain command (CC) and suppress length indication (SLI). 
TP OP code is 01. This is a write EOT for selection, 
count is 3. 

Therefore, the first channel command word in the channel program was to 
write a three-byte EOT sequence for selection from storage location 03992D. 
This is a write initial channel program. The TCAM PLM, shows channel 
programs for terminal operations. 

5. The station name is MARY. This is a six-byte field padded with blanks. 

6. The terminal is on line 015. 



The Formatted Table: If you specify COMWRTE= YES in the INTRO macro, you 
can get a formatted listing of the trace table. Only half of the table is written at a 
time on the COMWRITE data set. Use the IEDQXB utility to print the formatted 
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trace table. If you use the utility, remember that the most current entries in the 
trace table are still in main storage. 

Figure 42 is an example of the formatted output. SEQUENCE is a sequential 
count of the number of I/O trace tables printed. If a number is skipped, records 
have been lost. Prevent this loss by enlarging the size of your trace table. 



Subtask Trace Table 



Each table shows the time and date it is placed on the data set. Use the time to 
trace the activity on a line just before it fails, since you know when you lost the 
line. 



A TCAM service aid, the subtask trace, records the flow of all dispatched ele- 
ments. It shows where elements go in the TCAM system and which subtasks work 
on them. 

To use the subtask trace table, you must first understand the data flow as con- 
trolled by the TCAM dispatcher, and know how to use IEDQFE10, the subtask 
trace dump module. You must also understand the Method of Operation charts in 
the TCAM PLM. 

Activating the Trace: Whether this trace is available in main storage depends on 
how you design your MCP. To include it, code on the INTRO macro instruction 
the operand DTRACE=n, where n is an integer from 1 to 65535 that specifies the 
number of entries in the table. To format and print the table with the COM- 
WRITE routine and the IEDQXB utility, n must be between 4 and 65535. The 
default, DTRACE=0, specifies that there is to be no subtask trace. Include this 
operand at assembly time, or at INTRO execution time in response to the message 



**LlNE I/O TRACE** 


SEQUENCE- C00000 


37 

FIRST 




LINE 


STATUS 


INTRPT TP 


DATE- 71.211 
FIRST. TP 


TIME- 


07.32.29 


SENSE CSw 


INTERRUPT 


TERMINAL 








CCW 


CCW 


NAME 


AD0R 




UP CODE 


OP CODE 






00 


C9CCC7GC4CCC01 


02069C418C0400C2 


010348E56001GOC3 


C1D3C1404C4G 


0068 




C4 


CI 


ALA 




oc 


064CCOOC400CC8 


02G64C-8CCC080O09 


Cl034SEb6CC100C3 


C2D6E2404040 


0069 




OS 


01 


BOS 




00 


05F7FC0C4C3CC1 


020691018C340CC2 


C10348Eb600100C3 


C1D3C14C4040 


0068 




C4 
CO 


01 
01 


ALA 
CHAR 




0-0 


0643180C4COCCC 


G10688500C000C13 


C103492DA0010G33 


C3C8C1D94040 


0022 




00 


05F7F00C4C0C01 


0206904180040002 


O10348ES6OC100C3 


C103C1404040 


0068 




04 


01 


ALA 




00 


CDF7F00C40C0C1 


02069 10 18C04G002 


Oi03«»aE'5'60C'lCC03 


C1D3C 1404040 


0068 




C4 


01 


ALA 




00 


05F7FCOC40cOCl 


0206904 18CC4G002 


C10348E5600100C3 


C1D3C140404C 


0068 




04 


01 


ALA 




CO 


C5F7FC0C4CC 001 


0206910 18C04G002 


Cl034oE560C10303 


C103CI404C40 


0063 




04 


01 


ALA 




00 


05F7FCOC4C(..C01 
G5F7FC0C4CCG01 


020690418C040002 


010348E560010003 


C1D3C1404040 


0068 




04 


01 


ALA 




00 


020691018C04GC02 


C10348E560C10003 


C103C1404040 


0068 




04 


01 


ALA 




00 


05F7FC0C4CC001 


020690418C040002 


010348E5600100C3 


C1D3C1404040 


0068 




04 


01 


ALA 




00 


068C480CCOGG30 


01068C4C20000053 


0103492DAC0100C3 


C3C8C1094040 


0022 




00 


01 


CHAR 




00 


05F7F0CC4CCC01 


020691018C040002 


C10348E56001C003 


C1D3C1404040 


C068 




04 


01 


ALA 




00 


CbF7F00C4C0C01 


020690418C04COC2 


10348 £56001 000 3 


CTD3CT404C40 


"0068 




04 


01 


ALA 




00 


05F7FG0C4C0G01 
06 8'C480C"460C."0r" 


02G691018C04C002 


010348E56C010033 


C1D3C1404040 
C3C3ClD9^040 


0068 
0022 




04 
00 


01 


ALA 




00 


01C68C6FCOOC0030 


G2C64304600AOOC9 


0A 


CHAR 




00 


063C480C40000G 


01068C9ECO0C00C1 


020643G4600A0009 


C3C8C109404C 


0022 




00 


0A 


CHAR 




00 


05F7F00C4CC001 


0206904 18C040002 


C10348E5600i0003 


C1O3C140404O 


0063 




C4 


01 


ALA 




00 


ObF7FCGC4COC01 


G2 0691C18C0400 02 


C10348E5600100D3 


C1D3C1404C40 


0063 




04 


01 


ALA 




00 


C697E80C00CCC0 


CIC697EC2GOOC007" 


~0T.'0"34'B"EWa09"'C3"3V' 


"~C206"E2404"0'40" 


"™Cf0'6"9~" 




"■"w " 


"09 


BOS 




00 


3i>F7FG0C40CG01 
0643380E401 002 


020690418C040G02 
02068BC18C040002 


010348E560010003 


C1D3C1404040 


0068 




04 


01 


ALA 




01 


0103492060010003 


C3C8C1094040 


4022 


UC~ " 


04 


01 


CHAR 




00 


G64CC00C4C0CG1 


C 2 069 AC 18 0040002 


010348E560010003 


C2D6E2404040 


0069 




04 


01 


BOS 




00 


G5F7FO0C400CC1 


2 0691018 0040002 


C 10348E560010003 


C1D3C1404040 


0068 




C4 


01 


ALA 




00 


064CCC0C4CCC01 


020698218CO4C002 


01C348E56001C003 


C2D6E24C4040 


0069 




04 


01 


BOS 




00 


05F7FOOC400C01 


0206904180040002 


010348E560010003 


C103C1 404040 


0068 




04 


01 


ALA 




00 


0640COOC4COC01 


02069A018C040002 


010348E560010003 


C206E2404040 


0069 




04 


01 


BOS 




CO 


05F7F00C4CCC01 


02C691C18C040C02 


C10348E5600100C3 


C103C1404040 


0068 




04 


01 


ALA 




00 


064GCCCC400001 


020698218C040002 


C10348E560C10003 


C206E2404040 


0069 




04 


01 


BOS 




CO 


0SF7FC0C4CGC01 


0206904 18C040002 


010348E56001C003 


C1D3C1404040 


0068 




C4 


01 


ALA 




00 


C5F7FCOC400001 


02059101800400C2 


010348E560010003 


C1D3C1404040 


0068 




04 


01 


ALA 




00 


0640CC0C4CGC01 


02069AC16C340002 


' 010348E"56CrOlOOD"3"" 


~X2D6 _ E2~"4040~40~ 


0069 




. _._ c¥ 


01 


BOS 




00 


05F7F00C4CCG01 


020690418C040002 


010348E560C100D3 


C103C1404040 
C2D6E2404040 


0068 
0069 




04 
04 


01 

01 


ALA 
BOS 




CO 


3V0CCCC4CCC6T" 


02069 82 180C40002 


010348E560010003 




01 


0643380E4CC002 


02068BC18C040CC2 


0103<.92D6001G003 


C3C8C1D94040 


4022 


UC 


04 


01 


CHAR 




00 


05F7FOOC4CG001 


"02069'AO 18 0040002" 


010348E5600100D3 


C1D3C1404040 


" 0068 




04 


01 


ALA 





Figure 42. Formatted Line I/O Interrupt Trace Table 
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IED002A SPECIFY TCAM PARAMETERS 

that is generated only if you omit one of the following INTRO operands at 
assembly time: 

STARTUP=, LNUNITS=, KEYLEN=, and, if DISK=YES, CPB= . 

The response keyword is A=n or DTRACE=n. 

The trace table resides in the main storage allocated to the MCP and, therefore, to 
get a copy of the table, you must dump your MCP region. If you wish to dump 
the subtask trace table to a sequential data set to provide a history of TCAM 
activities, you must activate the COM WRITE routine for the subtask trace table 
dump by issuing the DEBUG operator command. 



control characters 



operation 



operand 



control chars 



/modify! 

V 



}« 



[procname.]id\,DEBUG = L,IEDQFE 1 
obname / 



Note: COMWRTE=YES must have been specified either at assembly or 
INTRO execution time. 

This loads (L) the dump routine for subtask trace. If you want to deactivate the 
routine, replace the L with D; otherwise, the command is the same. The routine 
prints half the table at a time to the sequential data set while the other half is 
being filled. Therefore, your most current entries are still in main storage. 

Example: Printing the subtask trace table when COMWRITE is used. 

//PRINT JOB MSGLEVEL=1 

//STEP EXEC PGM=IEDQXB,PARM='STCB' 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSN=COMWRITE,UNIT=2400,DISP=OLD,* 

// LABEL=( ,NL),VOL=SER=DUMMY 

/* 

The subtask trace table is also printed if no PARM= parameter is specified. 

Use the subtask trace to determine what TCAM was doing when it failed. A 
subtask trace table must be included with APAR documentation. You should 
print the subtask trace for any problem that occurs. To fully utilize the subtask 
trace, you should also dump main storage to get the remaining entries in the table. 

Using the Subtask Trace: Use the subtask trace, a logged history of internal 
resource and data movement in TCAM, to help you diagnose TCAM problems. It 
records the flow of all dispatched elements, showing where they go in the TCAM 
system and what subtasks work on them. 

While not all TCAM functions are logged, you can get a good picture of the flow. 
Although you do not need the trace to find a program check address, it can tell 
you the data movement preceding the check and which module passed control to 
the module that failed. 

Also, you can analyze hard waits and loops more closely when you have an 
excessive throughput reduction. You can trace loops among modules passing 
through the dispatcher and spot unnecessary WAIT conditions caused by poor 
resource allocation. 
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To begin with, know how to find the trace in main storage and how to define its 
parameters. The formatted trace printed by the IEDQXB utility serves as a good 
history, but your current problem is probably still in the main-storage table. This 
is usually true in the case of a program check, and in the case of most WAIT 
conditions. 

The Table in Main Storage: AVT+X'l A4' points to the 16-byte header of the 
table. If the dump program IEDQFE10 is not in the system, the table follows the 
header, which has the format shown in Figure 43. 

IEDQFE10 modifies the header and adds prefixes to each half of the table when it 
splits the table into halves for its own use. After IEDQFE10 splits the table, each 
half has the format shown in Figure 43. 

When you look at the trace table in a dump, if you see the C'STCB', you know 
that IEDQFE10 is in the system. If not, you see the header as it appears before 
calling IEDQFE 10. 

An example of a formatted subtask-trace table prefix is shown in Figure 44. 
The first entry points to either the first or second half of the table. 

In Figure 45 the second half of the table is being used, as indicated by the header 
pointers. 



AVT 



+ XMA4' 



♦ 



OFFSET FORMAT OF THE SUBTASK TRACE TABLE CONTROL BLOCK 






ADDRESS OF THE NEXT ENTRY IN THE TABLE 


4 


ADDRESS OF THE FIRST ENTRY IN THE TABLE 


8 


ADDRESS OF THE LAST ENTRY IN THE TABLE 


2 


SIZE OF THE TABLE 



OFFSET 



FORMAT OF A SUBTASK TRACE TABLE ENTRY 



12 



PRIORITY OF THE 
DISPATCHED ELEMENT 


ADDRESS OF THE 
DISPATCHED ELEMENT 


ENTRY POINT ADDRESS OF 
THE DISPATCHED SUBTASK 


FLAG BYTE OF THE 
DISPATCHED QCB 


ADDRESS OF THE 
DISPATCHED QCB 


SUBTASK ENTRY 
CODE (MCPL) 


ADDRESS OF THE DISPATCHED STCB 



Figure 43. Subtask Trace Table Format 
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Note: The address of the current entry is a pointer to the location where the 
next entry will be placed. Therefore, the latest entry in the table is located 
16 bytes before the address contained in the first word of the header. 

Contents of an Entry: Each entry in the trace table is 16 bytes of information in 
the following format. 



ONE WORD 



FIRST ENTRY 



CURRENT ENTRY 



LAST ENTRY 



SIZE OF TABLE 



CSTCB' 



TIME 



DATE 



CT 



AVT ADDRESS 



Modified Header (16 bytes) 



Prefix for first half of table (16 bytes) 



ENTRIES 



CSTCB' 



TIME 



DATE 



CT 



AVT ADDRESS 



Prefix for second half of table (16 bytes) 



ENTRIES 



Each entry is 16 bytes 



Figure 44. Formatted Subtask Trace Table Prefix 
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+0 priority of the 

dispatched element 


address of the 
dispatched element 


+4 address of the entry point of 
the dispatched subtask 


+ 8 flag byte of the 
dispatched QCB 


address of the 
dispatched QCB 


+ 12 subtask entry 
code (MCPL) 


address of the 
dispatched STCB 



Priority of the dispatched element: The one-byte relative priority of the element 
used by the TCAM dispatcher. Figure 46 is a list of relative priorities. The actual 
meaning of the priority field depends on the type of element. 

Address of the dispatched element: The main-storage address of the resource 
control block (RCB) associated with the dispatched element. The RCB is a 
two-word prefix to an element that allows the TCAM dispatcher to determine the 
QCB to which an element will be posted. Each element in the TCAM system is 
represented by an RCB. An element is an individual part of a system resource 
(for instance, a buffer, an LCB, etc.). To determine what type of element is being 
dispatched, examine the element. First, check the formatted section of your dump 
to see if it is an LCB. If it is not, it is a buffer if it is located in the buffer pool 
area (AVT+X'384' points to the start of the buffer pool). If it is neither an LCB 
nor a buffer, it could be an ERB (element request block) used to request buffers 
for transmitting data. The ERB is X'4C beyond the beginning of the LCB. 

Address of the entry point of the dispatched subtask: The entry-point address 
of the module that will act on the element. 



+ 42O0A4) 



06B860 
06B880 
06B8A0 
06B8CO 
06B8E0 
06B900 
06B920 




003A0008 01000650 OCOOO000 00000000 Y CURRENT 0OC FIRST 01 LAST^° 0C SIZE 3 * 8 * 

0C03SS7C C0077348 OC039B50 START 1 u »m. .. ... 00G««=^ 00 »uu6 OO uvjuu O * * 

00019B88 000198D8 OCOOOOOO OF TRACE 1 * f_0006CD 20 0006C850 0006D7D0 00001F50 * Q H...P * 

E2E3C2C2 09092046 0071292F 0TABLE v COOfaAODO OOOdOCOA Y ^OtiACDO OCCOAOCO '' *STCB C. ...U..G.. . .* 

ECC6AC08 00068E3A 0006AOD8 0C06A0E0 E406A124 0(C0NTR0L SECTION 04042338 *...Q Q....U * 

E406A124 00042902 02039CB8 04042900 00039C2C O0C42902 0C039AE0 00C39C2C *U * 

E706ACC8 0003FB9C C903FB90 0603FB98 E406D060 000424F8 02039C88 040424F6 *X..Q....I U......8 6* 



PREFIX 

06C820 E006A0C8 00068E3A 0006A008 0C06aucu 

06C840 E406A124 00042902 02039CB8 04042900 

06C860 00039C2C C00429C2 OC039AE0 00039C2C 

06C880 E406DS6C 00042902 02039CB8 04042900 

06C8A0 E706A0C8 0003FB9C C903FB90 0603FB98 

06C8C0 E3C6ACC8 C003FDE0 1003FD04 0603FDDC 

06C8E0 E006AOC8 00068E3A 0006AOD8 0C06A0E0 



^ 



E406A124 Q004233A 08039C7C 04C42338 *...Q Q....U * 

E2E3C3C2|09085761|0071292F|0EC39S70| *U STCB * 

E006D96C 0003FB9C C903FB90 06C3FB98 * R I * 

00039C2C 00042902 00039AE0 00039C2C *U.R * 

E406DD60 000424F8 02039C88 040424F6 *X..Q....I U 8 6* 

E006A0D8 00068E3A E406ACD8 OCC6A0EO *T. .Q M Q. . ..U..Q. . ..* 

E406A124 C004233A 08039C7C 04C42338 *...Q Q....U * 



Figure 45. Second Half of the Subtask Trace Table 
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Name Value 



Use in an ERB 



PRINTRQ E4 to request full buffers 
from Disk I/O 



PRIFSPCI E8 to request empty buffers 

from buffer request 
QCB; to request full 
buffers from Disk I/O 

PRISBPCI EO to request empty buffers 

from buffer request 
QCB; to request full 
buffers from Disk I/O 
to request an empty unit 
by chaining the ERB on 
the buffer return QCB 

in tposting ERB to the 
activate QCB to request 
building an initial 
contact program and 
EXCP for the line 

to enable EOB to recall; 
to tpost to EOB Handling 
after an EOB error; must 
be lower priority than 
PRIMHBFR 

to request from Disk I/O 
a copy of the header 



PRIDSKRQ EC 



PRIACTIV E4 



PRIDKEOB EO 



PRIRECAL EO 



PRIRCQCB EO to return the ERB to any 
routine specified in 
LCBRCQCB 

PRIAPERB DO to request full buffers 

PRIEDISP EO to tpost ERB to itself 

on send operations when 
an error occurs before 
EOM; must be lower 
than PRIMHBFR 



PRIMHBFR E4 



to have a buffer 
processed by MH 



'RIUREQ E8 to request an empty 

unit for insert function 
in MH; must be higher 
than PRIMHBFR 

■RIAPBFR DC to tpost a buffer to an 
application program 



'RILNEND E4 



to have Buffer Disposition 
finish processing macros 
and clean up the line 



RIRCBFR 



RIBFRTB 



EO to return a duplicate 
header to a specified 
routine 



E4 



to return a buffer or unit 
to the buffer-unit pool 



Routines Using 

Send Scheduler 

Receive Scheduler 

Get Scheduler 

Put Scheduler 

Create an error message 

routine 

PCI Appendage-on first 

PCI only 

Multiple Routing subtask 



PCI Appendage-all 
PCIs except the first 



CPB Cleanup 



CPB Cleanup 
Buffer Request 
Buffer Return 



CPB Cleanup 
CPB Initialization 



All routines requesting 
recalled headers 
Multiple Routing subtask 

CPB Cleanup-after recall 
Create an error message 
routine 

Application program 

Buffer Disposition 



PCI Appendage 
CPB Cleanup 
Line End Appendage- 
receive, last buffer only 

Unit Request 



Incoming/Outgoing Message 
Delimiter routine 

Line End Appendage-send, 
last buffer only 



CPB Cleanup 
Destination Scheduler 



Incoming/Outgoing Message 
Delimiter routine 
PCI Appendage 
CPB Cleanup 
Destination Scheduler 
Multiple Routing subtask 



Name Value Use in an ERB 

PRIDSKBF EC to give a unit to 
CPB Cleanup 

PRICOPY EO to have a message copied 
to a different data set 

PRIDESTQ E4 to put a buffer on a 
message queue 



PRIDKWRT E4 

PRIDKSRV EC 

PRIDKCNC EO 

PRIDKINT EO 

PRICKPLN EC 

PRIMULTR EO 

PRIOPCTL DC 



to have a full buffer 
written on disk 

to have a message 
flagged serviced 

to have a message 
canceled in the 
message queue 

to have a message 
intercepted 

to tpost the LCB to 
Checkpoint requesting 
a checkpoint 

to tpost the LCB to 
the Multiple Router 
routine to continue 

to tpost an operator 
control buffer 



PRIDSPLB E4 to tpost last buffer of 
message to buffer dis- 
position QCB; must be 
lower than any PCI 
tpost of an ERB 

PRIONLT DC to request on-line test 

PRILAEND E4 to start error processing 

PRIMHUNT E8 to tpost a unit to MH; 
must be greater than 
PRIMHBFR 

PRIRELSE EO to release a subtask 

from Time Delay or 
Operator Control 

PRICPBCL E8 to post CPB Cleanup 
complete 

PRICKPT DC to request a complete 

checkpoint 



PRILNFRE E8 to free a line; must get 
to Destination Scheduler 
before line is free 

PRICLSDN 10 to request closedown; 
must be lowest priority 

PRIAPCKP DC to request an incident 
checkpoint 

PRIOPCKP DC to request an incident 
checkpoint 



Routines Using 
Buffer Return 

Destination Scheduler 



Incoming/Outgoing Message 
Delimiter routine 
Multiple Routing subtask 
Create an error message 
routine 

Destination Scheduler 



Buffer Cleanup 
Cancel Message 



Hold/Release Terminal 
routine 

Buffer Disposition 



Buffer Disposition 
TLIST 



Message Handling routine 
Operator Control 
Interface routine 

Incoming/Outgoing 
Message Delimiter routine 



STARTMH subtask 
Line End Appendage 
Unit Request 



Operator Control 
Hold/Release Terminal 



Disk End Appendage 



Reusability-Copy subtask 

MCPCLOSE 

Time Delay subtask 

Buffer Disposition 
Put Scheduler 
Send Scheduler 



Application Program 
Operator Control 



gure 46. TCAM Relative Priorities (Part 1 of 3) 



Figure 46. TCAM Relative Priorities (Part 2 of 3) 
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Name 


Value 


Use in an ERB 


Routines Using 


PRILNCL 


EC 


to clean up buffers 
and to free a line; 
to tpost a line to 
Buffer Disposition 


Line End Appendage 

INEND 
OUTEND 


PRILOGLB 


EO 


to tpost the Log LCB 
to itself 


LOG Scheduler 


PRISSOLT 


DC 


tposted to Operator 
Control to request 
STARTLINE/STOPUNE 
to return an element 
from the time delay 
queue 


On- Line Test 
Time Delay 


PRIATTN 


DC 


to tpost the attention 
element for local 
devices 


Attention Handler 


PRISYSDL 


DC 


to initiate system delay 


Operator Control 


PRISYSDT 


D8 


to tpost the system delay 
QCB to Time Delay 


System Delay 


PRILCBDL 


20 


to indicate to 
Environment Checkpoint 
that an LCB is on the 
System Delay 


System Delay subtask 
Environment Checkpoint 



NOTE: All EOM (end of message) buffers have DF in the priority field of the 
RCB. 

Figure 46. TCAM Relative Priorities (Part 3 of 3) 



Flag byte of the dispatched QCB: The first byte of the QCB. Sometimes its 
contents are meaningless. If the flag byte is C9, the buffer disposition routine is 
to be tposted. If, however, this is a destination QCB, these flags indicate which 
destination QCB the dispatcher is to use, and which message queues data set is to 
receive messages for the destination. 

Bit definitions are: 



Bits 
1,2 



1,3 



Value 
X'60' 



X'50' 



Meaning 

main-storage queues with backup on 

nonreusable disk 

main-storage queues with backup on 

reusable disk 

main-storage-only queues 

nonreusable disk queues 

reusable disk queues 

this is a QCB 

stop sending while reusability clears this queue 

Address of the dispatched QCB: The address of the queue control block (QCB) 
whose first STCB will be activated. A QCB regulates the sequential use of 
elements among requesting tasks. Every queue or item waiting for service in the 
system has a QCB. 

Subtask entry code (MCPL): Using this field, the TCAM dispatcher calculates 
the subtask entry point. 



1 


X'40' 


2 


X'20' 


3 


X'10' 


6 


X'02' 


7 


x'or 
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Code Meaning 

X'04' the subtask entry point immediately follows a 

2-byte STCB (subtask control block) 

X'06' the subtask entry point immediately follows a 

4-byte STCB 
X'08' the subtask entry point immediately follows a 

6-byte STCB 
X'OA' the subtask entry point immediately follows an 

8-byte STCB 

If the MCPL value is greater than X'OA', the TCAM dispatcher activates a 
subtask by using the MCPL field as an index into the AVT subtask branch table at 
AVTDISP (AVT+X'228'). The following values of MCPL cause the dispatcher 
to activate the associated subtask. 

Code Subtask 

X'OC leased receive scheduler 

X'OE' send scheduler 

X'10' GET scheduler 

X'12' PUT scheduler 

X'14' GET FIFO scheduler 

X'16' log scheduler 

X'18' dial receive scheduler 

X'lA' buffered terminal scheduler 

X'lC retrieve scheduler 

X'lE' local receive scheduler 

If the MCPL field is X'OO', no real elements are currently tposted to the ready 
queue. A subtask residing in the dispatcher issues an OS WAIT command. 

If the MCPL field is X'02\ the element has been tposted to a QCB that represents 
an attached TCAM task (operator control, checkpoint, or on-line test). The 
dispatcher activates a subtask residing in the dispatcher that enqueues the ele- 
ment. OS posts the subtask. 

Address of the dispatched STCB: The address of the dispatched subtask control 
block for the module that will be activated (the module whose entry point is in the 
second word of the trace entry). 

The TCAM dispatcher places an entry in the subtask trace table immediately 
before branching to the routine. Therefore, the entry indicates what is going to be 
done to the element. The function has not yet been performed. 

The following example of a main-storage subtask trace table points out the normal 
flow of a received message, a sent message, and a negative response to polling. 
Once you become familiar with this flow, you will find it easier to identify addi- 
tional TCAM functions in a table. Checkpoint, application programs, logging, and 
multiple routing change the number of entries, but you should always be able to 
pick out the basic message flow. 

The subtask trace can be used more effectively With a storage dump to allow you 
to verify the exact module or element involved in the activity. 

Figure 47 (Parts 1-3) shows how to read an entry. The numbers under each field 
correspond to the numbers in the following discussion. 
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06CAC0 
06CAE0 
06CB00 
06CB20 
06CB40 
06CB60 



EC06DS6C C003FB9C C903FB90 0603FB98 
E006D920 00065490 EC06D920 1806D928 
|E4|06PS6C| 00042902 | 02)039CB8| 041042900] 
Vt*06£NC8 000f5\B9C (2Y03F(5yO fgV 03 ^ 8 
^06^08 OOO^OEO ^03^)4 1^03^0 
EC06ACC8 00068E3A OC06A0D8 0C06A0E0 



E306D920 0003FOEO 1003FD04 0603F00C *..R I T.R M....* 

E406096C 0004233A 08039C7C 04042338 *..R R...R.U.R * 

00039C2C 00042902 00039AE0 00C39C2C *U.R * 

E406AB20 000424F8 02039C88 04C424F6 *X..Q....I U 8 6* 

E006A008 00068E3A E406A008 0C06ACE0 *T..Q M Q. ...U..Q. . ..* 

E406A124 0004233A C8039C7C 04042338 *...Q Q....U * 



Figure 47. Reading a Subtask Trace Entry (Part 1 of 3) 



06D900 
06D920 
06D940 
06D960 
06D980 
06D9A0 



1. E4 is the relative priority. You need more information from the trace before 
you know its actual relevance. 

2. 06D96C is the address of the RCB (the dispatched element). Go to this 
address in the storage dump. 



ccccocco cocooooo ocoooooo oooooooo 

E0C6D920 E0039C2C 18C6D928 20068F94 

50000000 



C2000CCC 7F039BEC Oy^gflOO OOO 
00C6E7E0 C0000202 Ocui'i'OOT HobTo 



39CB8 



OC02BK8 51111106 01030408 0«QCB 
OC06DSB0 00039970 0C06D898 OCftODRESS 



OOOCOOCO 19498916 0006D918 0006D918 * R...R.* 

00001400 10000000 OOOOOOOO 18CO0C0O *..R R * 

4006D9CO 0003A908 0404FB90 OCOOOOOO *B R * 

|E4|039C2Cl 0106E7E0 OOOOOOOO 40060898 *..X U X Q.* 

OOADDRESS OF)001 01580001 600658EA *...H * 

02NEXT RCB >°°1 0806D9BO 0006E7EO *..R Q R R...X.* 



Figure 47. Reading a Subtask Trace Entry (Part 2 of 3) 

The RCB is a two-word prefix to an element with the following fields. 



4-0 


key field 


address of QCB to which this RCB is tposted 


+4 


priority 


address of next RCB in the chain in which 
this TCB is located 



To determine what type of element is being dispatched, examine the element. 
First, check the formatted section of your dump to see if it is an LCB. If it is 
not, it is a buffer if it is located in the buffer-pool area (AVT+X'384' points to 
the start of the buffer pool). If it is neither an LCB nor a buffer, as in this case, 
it could be an ERB (element request block) used to request buffers to transmit 
data. The ERB is X'4C beyond the beginning of the LCB. To verify that it is 
an ERB, subtract X'4C from the address in this field. Now check the format- 
ted section of your dump for this LCB address. In this example, 

6D96C 

-4C 

6D920 

6D920 is an LCB address indicating an ERB as the element being dispatched. 
The entry-point address of the dispatched subtask is 042902. At this address in 
storage, you can see which module is about to be activated. Looking in the 
right-most column, you see the module identification IEDQKA, the Activate- 
I/O Generator subtask. 



/ENTRY POINT 

0428CC CX061E2B 42230007 92C2300B 92083008 

0428E0 4C>^7E0 C5B89101 6C140711 4300401C 

042900 I0400E C EF C00C47F0 F01CC9C5 C4D8C2C1 

042920 STCB : 0FC26 4B20FBBE 56402C34 91402013 

042940 41C0F1CC C55C98BF DCCCD2C1 205A203E 

042960 92E41004 94FD1014 5C710000 47F0B04E 



1299C72E 92203004 109907FE 1B009101 
07F1430C A03907F1 0004233A 08000C01 
10561821 91081008 4780F022 5821CC0C 
478CF03E 5860D29C 5860601C 45360018 
9101202C 4780F06E 58704014 58102C40 
41102020 0A0098BF D00C9140 20474770 



* ...E 1 1 * 

* 00. IEDQKA * 

*.00.... 0...K * 

*..l K. * 

*.U * 



Figure 47. Reading a Subtask Trace Entry (Part 3 of 3) 
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4. The flag byte of the QCB is meaningless in this example. 

5. The address of the dispatched QCB is 039CB8. This is the QCB to which the 
element is tposted. As you can see, it is the same as the first word in the RCB. 

6. The MCPL field is 04, which says that the entry point of the subtask immediate- 
ly follows the two-byte STCB. 

7. The address of the STCB for the subtask to be activated is 042900. You now 
know enough to understand the priority field. Looking at the list of relative 
priorities in Figure 46, you can see that an E4 priority indicates tposting an 
ERB to the Activate QCB to request building an initial channel program and 
EXCP for the line. 

The Formatted Table: The trace table in main storage contains the most current 
entries. You may find the formatted trace printed by IEDQXB useful when 
intermittent failures require a history of what has been happening in the TCAM 
system. Figure 48 shows the printed output. Field headings are: 

Subtask trace: The title of the table. 

Sequence: A sequential count of the number of tables written on the data set. 
If a number is skipped you have lost entries; that is, the table half in main 
storage wrapped because COMWRITE was busy and could not write it to the 
data set. Prevent this problem by increasing your table size. 

A VT address: The address of the AVT (address vector table). 

Date/ time: The date and time at which the table was placed on the data set. 
You can dump selectively using the time. 

First type QCB and second type QCB: Not significant, other than telling you 
that the right-most 16-byte entry was made first. 

Pri: The priority of the dispatched element. 

Ele: The address of the dispatched element. 

Entry: The address of the entry point of the dispatched subtask. 

Fl: The flag byte of the dispatched QCB. 

QCB: The address of the dispatched QCB. 

Ml: The subtask entry code (MCPL). 

STCB: The address of the dispatched STCB. 

Use the translation of the module name to follow the flow of activity. Remember, 
however, that these translations are general descriptions of the module activity, 
and are sometimes misleading. Do not depend on this translation; go to the 
addresses specified to see which module is acting on the element. The translation 
helps explain the module activity. 

QCB POSTED TO ITSELF indicates an LCB being posted to itself. 

ACTIVATE is the Activate-I/O Generator routine. 

Using the Table: To further help you understand this trace and its use, a list of 
hints of what to look for in determining the cause of the problem follows. 
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♦♦SUBTASK TRACE** 
FIRST TYPfc CCb 


PPl' 


SEQUENCE- 03 
ELE tNTRY 


t 
FL 


&VT AUCRESS- CA13F0 

CICU ML STCB SECOND TYPE UCB 


UCB PCSTED TO ITSELF 
AVAILABLE BUFFER 


EO 
EA 


C72CF8 
C721AA 


C63B02 
CA762A 


EA 
08 


072CF8 OC 
0A16FC OA 


C721C0 
0A7628 


UCB POSTED TU ITStLF 
ACTIVATE 






CO 


CA16AC 


0A7BF2 


00 


0A156C 00 


0A16AC 




BUFFtR RETURN 




EA 


C69CC0 


CA77fc8 


02 


CA17C6 OA 


0A77E6 


BUFFER RETURN 


UCfl PCSTED Tti 


ITSELF 


to 


C72CF8 


063BU2 


EA 


072CF6 OC 


C 72 10 


QCB POSTED TO ITSELF 


AVAILABLE BUFFER 


FA 


C721AA 


CA762A 


08 


0A16FC OA 


OA-?fr*tf -A-Ef iVATfc - 






CO 


0A16AC 


CA7BF2 


00 


0A156C 00 


CA16AC 




BUFFER RETURN 




EA 


otsocc 


CA7/Eb 


02 


0A17C8 OA 


0A77E6 


BUFFER kETURN 


OCil POSTED TO 


ITSELF 


EC 


C720F8 


C63BLV 


EA 


072CF3 CC 


C72100 


OCO POSTED TU ITStLF 


AVAILABLE BUFI-ER 


EA 


C721AA 


Ca7o2A 


Ob 


0A16FC OA 


0A762a 


ACTIVATE 






CO 


CAlfaAC 


LA7BF2 


CO 


0A1560 00 


0A16AC 








E3 


C65C68 


CAU96C 


10 


0AB96C 06 


0Atr96 8 


••KB POSTtO Tu ITSELF 


gCd PCSTEQ TC 


ITSELF 


EO 


G65Cte 


C63dD2 


Ou 


065C68 CC 


065070 


AVAILABLE BUFFER 


ACTIVATE 




EA 


065CBA 


0A7dF2 


2 


0A1738 OA 


0A7BF0 


ACTIVATE 






t7 


C720F8 


CAB73H 


C9 


0AB728 C6 


0AB73C 


BUFFER RETURN 






F3 


0720FH 


CA'iSoC 


10 


0AB96C 06 


0AB9oB 


QCB PUSTED TO ITSELF 


OCb FLSTEC TC 


ITSELF 


to 


C72CF8 


C636J2 


OL' 


C72CF8 CC 


C72100 


AVAILABLE BUFFER 


ACTIVATE 




FA 


C721AA 


0A/dF2 


2 


CAl 73B OA 


OATBFtf- 


ACTIVATE 






E7 


C72CF8 


CAJ73A 


C9 


CAB728 Ob 


OAb/30 


BUFFER RETURN 






E3 


C72CF8 


0ABS6C 


10. 


0AB96C 06 


0AB968 


QCB PUSTED TU ITSELF 


CCB PCSTtC TC 


ITSELF 


EO 


C72CF8 


063bu2 


00 


072CF8 OC 


C72100 


AVAILABLE BUFFER 


ACTIVATE ' 




EA 


C721AA 


CA7BF2 


C2 


CA1736 OA 


0A7BhO 


ACTIVATE 






E7 


072CF8 


PA37jA 


C9 


0AB726 06 


CAB730 


3UFFEK RETUKN 






t3 


C72CF8 


CAUSbC 


10 


0AB9o(.- 06 


CAd9ad 


•JCb PtJbTEO TL- ITSEL+ 


gco PCSTto to 


ITStLF 


to 


C72CFH 


C6JoO^ 


a 


C72CFb CC 


C721UO 


AVAILABLE BUFFtR 


ACTIVATE 




EA 


C721AA 


CA7BF2 


v,2 


C A 173d CA 


CA7rtl-u 


ACT I VATt 






E7 


072CF8 


CAl) 7 jm 


C9 


0AB728 06 


0AB73O 


8UFFER RETUkN 






E3 


L72CF8 


CABSbC 


10 


CAB96C 06 


•JABSib-i 


QCa POSTED lu ITStLF 


acd pesTeu tc 


ITSELF 


to 


C72CF8 


C 6 3 1\ 2 


0- 


072CF8 CC 


:72100 


AVMlLABLt BUFFtR 


ACTIVATE 




EA 


U721AA 


OA7»F2 


2 


0A173O OA 


0A7-)FO 


ACTIVATE 






l7 


C li^iF h 


CA07JA 


C9 


C A 872b C6 


CAi-730 


8UFFER RETURN 






E 3 


C72Cto 


CAsiSfcv. 


10 


C'Ad96l Ob 


0Ad)68 


jCd PJSTtO TC 11 ScLF 


CCo PCSIcL TO 


ITStLt 


lO 


C 7^cFS 


6 J ii u i 


00 


C72CFO OC 


72 100 


AVAILABLE BUFFER 



OATE- 71.139 TIME- 13.AA.51 
PRI ELE ENTRY FL QCB ML STCB 



EO 0720F8 063B02 
EA 0721AA 0A7BF2 
£7 072CF8 0AB73A 
E3 0720F8 0AB96C 
EO 0720F8 063B02 
-fcA e7^1AA-OA7iH=2 
E7 0720F8 0AB73A 
E3 0720FU 0A696C 
EO 0720F3 0636D2 
EA 0721AA 0A7BF2 
EO 0650BA 0AB73A 
E0-O6-5O6-8 -06 36-0-2- 
EA 0650BA 0A762A 
00 0A16AC 0A7BF2 
EA C69CC0 0A77E8 
EO 0720F8 063602 
tA C721AA 0A762A 
00 0A16AC OA7BF2 
CI 069000 0A77E8 
EO C720F8 C63BD2 
EA 0721AA 0A762A 
00 0A16AC 0A7bF2 
EA 0690C0 0A77E8 
tO 0-72CF8 e6 3tti)2 
tA C721AA 0A762A 
00 CA16AC 0A7BF2 
tA 069000 CA77E6 
EO 0720F8 C63BD2 
EA u721AA CA762A 
00 0A16AC uA7t'F2 
EA 0o9CC0 CA77E8 
tO C720F8 C63B02 
tA 0721AA 0A762A 



00 0720F8 OC C72100 

02 0A1738 OA CA7BF0 
C9 0AB728 06 0AB730 

10 0AB960 06 0AB968 
00 0720F8 OC 072100 

C9 0AB728 06 0AB730 

10 0AB960 06 0AB968 

OC 0720F8 OC 072100 

02 OA1738 OA 0A7BF0 

C9 0AB728 06 0AB730 

"E^) 065068 OC"065070 

08 0A16FC OA 0A7628 

00 0A156C OC 0A16AC 

02 0A1708 OA 0A77E6 

EA 072CF8 OC C7210O 

08 CA16FC OA 0A7628 

oo -o*i-5*-o-©e--e*t*-AC- 

02 CA17C8 OA 0A77E6 

EA 072CF8 OC C72100 

08 0A16FC OA 0A7628 

CO 0A1560 00 0A16AC 

02 CA1708 OA CA77E6 

EA 0T2CF8 'it OT210O 

06 CA16FC OA 0A7628 

CO 0A1560 00 0A16AC 

02 0A17C8 OA CA77E6 

EA C72CF8 OC C72100 

08 0A16FC OA 0A7628 

00 CA1560 OC 0A16AC 

C2 0A1708 3A 0A77E6 

EA 0720F8 OC C72100 

C8 CA16FC OA 0A7628 



Figure 48. Formatted Subtask Trace Table 



1 . Practice reading normal message-flow entries so you can more readily identify 
error flows. 

2. Know the dispatching concept, control block linkages, and the data move- 
ment initiated by the subtasks and the dispatcher (see the TCAM PLM.) 

3. Learn to recognize the scheduler MCPL fields. 

4. Determine where the flow went wrong. Experience and the PLM will help 
here. Always try to associate the trouble with a line. This gives you an LCB 
to follow. Find the last time the LCB was shown free, and trace the flow 
forward to the failure. 

5. Become familiar with pertinent MCPL fields, QCB addresses, and QCB flags. 
Priority fields in a buffer can tell you where the buffer should go. 

6. Determine what negative polling and addressing responses look like. Use 
Figure 49 (Parts 1-3) to help diagnose the reason for line failures. 

7. On program checks, the last two or three entries in the trace table will in most 
cases give you an idea of what was happening. 

8. The SCB parameter list for the message handler macros tells you which 
functional macro routine has control if you get a program check in the mes- 
sage handler. 

9. Check the buffer prefix fields for proper disposition of the buffer being 
handled at failure. 

10. Identify the immediate entries before a loop or hard wait because they often 
lead to the source of the error. 

Once you identify the LCB for the failure being traced by the subtask trace, you 
can note the interrupts and associate the line I/O entries. You can associate both 
line I/O and buffer traces with the subtask entries using the LCB and line information. 
Doing this, you can correlate the entire TCAM line activity. 
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- 


deceive Operation 


- 








05BA60 


E0066038 


00057082 


00066038 


0C066040 


E4066084 


0003CI5A 


E40355D4 


0403CI58 


05BA80 


E4066084 


0003C722 


02035610 


0403C720 


00035584 


0003C722 


00035438 


00035584 


05BAA0 


E8035640 


0003AD02 


02035640 


0403AD00 


00035584 


000453A8 


00035438 


00035584 


05BAC0 


E8066084 


0003CI5A 


E40355D4 


0403CI58 


00035584 


00035423 


00035438 


00035584 


05BAE0 


E405D000 


000408E0 


0F036F38 


0A0408D8 


E405D000 


0003F962 


0F036F38 


0403F960 


05BB00 


DF05D000 


000404CC 


C90400C0 


080404C8 


E405D060 


0003C3I8 


020355E0 


0403C3I0 


05BB20 


E405D000 


00057B5A 


62038B70 


0E038B78 


E405D000 


0003DCF6 


62038B70 


0803DCF0 


05BB40 


E405D000 


0003A772 


02035634 


0403A770 


E4059580 


0003C3I8 


020355E0 


0403C3I6 


05BB60 


E6066084 


000404CC 


C90404C0 


06040468 


E8035640 


0003AD02 


02035640 


0403AD00 


05BBS0 


E3066038 


00040704 


I00406F8 


06040700 

try Type Denoting 


E0066038 

v. 


00057082 


00066038 


0C066040 

j 




End of a Receive 0| 

E4066084 


> 


r 
080355D4 






f Same En 


0003CI5A 




"05C300 


r 
E0066038 


00057082 


00066038 


0C066040 


0403CI58" 


05C320 


E4066084 


0003C722 


02035610 


0403C720 


00035584 


0003C722 


00035438 


00035584 


05C340 


E7066038 


000404CC 


C90404C0 


060404C8 


E405CB20 


0003C3I8 


020355E0 


0403C3I6 








- Negative Response to 


Polling - 








.05C360 


E3066038 


00040704 


I00406F8 


06040 700 


E0066038 


00057082 


E4066038 


0C066040, 


05C380 


E0066038 


00057B5A 


00066038 


0E038B78 


E4066084 


0003A772 


02035634 


0403A770 


05C3A0 


E4066084 


0003C722 


02035610 


0403C720 


00035584 


0003C722 


00035438 


00035584 


05C3C0 


E4059580 


000408E0 


0F036F38 


0A0408D8 


E4059580 


0003F962 


0F036F38 


0403F960 


05C3E0 


E405D000 


0003C3I8 


020355E0 


0403C3I6 


00035584 


0003C3I8 


00035438 


00035584 


05C400 


00035584 


000052C2 


00035438 


00035584 


E4059580 


000404CC 


C90404C0 


060404C8 


05C420 


E0066084 


0003A772 


02035634 


0403A770 


E0066084 


000404CC 


C90404C0 


060404C8 


05C440 


E405CF40 


00043842 


I20390C0 


I60399C8 


E405CF40 


0003DCFG 


I20390C0 


0803CDF0 


05C^+60 


E005CF40 


00046 IB4 


00046 IA8 


060461 B0 


00035584 


00009C22 


00035438 


00035584 


05C480 


E8035640 


0003AD02 


02035640 


0403AD00 

- Send Operation - 


00035584 


00009C22 


00035438 


00035584 




LINE 05C4A0 


SAME AS ABOVE 










05C4C0 


E8035640 


0003AD02 


02035640 


0403AD00 


E005CF40 


000404CC 


C90404C0 


060404C8 


05C4E0 


EC059580 


0003A772 


02035634 


0403A770 


E405CF40 


0003C3I8 


020355E0 


0403C3I6 


05C500 


E405CB20 


0003C3I8 


020355E0 


0403C3I6 


E405D060 


0003C3I8 


020355E0 


0403C3I6 


05C520 


E3066038 


00040704 


I00406F8 


06040700 


E0066038 


00057B5A 


E4066038 


0E038B78 


05C540 


E0066038 


00057082 


00066038 


0C066040 











Figure 49. A Receive, a Negative Response to Polling, and a Send Operation (Part 1 of 3) 
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RECEIVE OPERATION FROM A TERMINAL 

LCB [posted to itself is the beginning of a Receive operation. First word is the LCB 
as an element. Third word is the LCB as the QCB. MCPL = OC. 

ERB in LCB is tposted to Buffer Request. Fourth word is the subtask IEDQGA address. 

GA tposts the ERB toActivate, IEDQKA. 

KA started the line. Return to the dispatcher found nothing on the ready queue. 
WAIT issued. MCPL = 00. 

CPB Cleanup QCB tposted to itself. QCB is on the queue by Disk End 
Appendage for a previous open. I/O interrupt for Disk End Appendage gave 
dispatcher control. 

IGG019RC for the previous disk open started disk I/O. With no work yet to do for 
the receive, the CPB Cleanup is dispatched. The dispatcher, when it next gains 
control, issues a WAIT again. Data is still filling the buffer for the Receive. 

Result of first PCI interrupt. Request for BUFMAX. E8 priority in ERB means ERB 
tposted to GA for first PCI request. 

WAIT after PCI service. Line now filling the last of the buffer to go on to the next 
or finishing last of the message. 

Buffer has been tposted to EOB/ETB IEDQBT subtask on the STARTMH QCB. 
Some form of user option specified in STARTMH macro. 



The buffer is bypassed to IEDQAA by the dispatcher. 

All EOM buffers have 'DF' in the priority field of the RCB. After INHDR and 
INBUF processing, the buffer is tposted to Buffer Disposition, IEDQBD. 



BD tposts any unused buffers to Buffer Return, IEDQGB. This would be the extra 
buffer gotten by the PCI interrupt. 

BD tposts the message buffer to the Destination QCB. QCB flag = 62. This shows 
main-storage queues with nonreusable disk backup. 



Send Scheduler bypasses control to the Destination Scheduler by the dispatcher 
entry point DSPBYPAS. 

Destination Scheduler (IEDQHM) tposts the buffer to CPB Initialization, IEDQFA. 

FA swaps the buffer with the CPB unit. CPB unit is returned to the buffer-unit pool 

by being tposted to IEDQGB. 

EXCP is done to write on the disk queue. 

Low-priority ERB on the ready queue for Buffer Disposition to process INMSG macros. 
This is done after FA starts the Disk I/O to utilize the time that the channel is 
writing on disk queue. 

CPB Cleanup QCB tposted to itself. Done by Disk End Appendage. 

INEND macro signals BD to tpost the LCB to BD's second entry point: E3 in 
priority field of LCB. 

IEDQBD02 entry point of BD will tpost the LCB to itself to signify the end of receive. 
Line is free. 



E0 066038 00057082 00 066038 0C066040 

E4066084 0003CI5A E40355D4 0^03C 158 
E4066084 0003C722 02035610 0403C720 
0003558*+ 0003C722 00035438 00035584 

E8035640 0003AD02 02035640 0403AD00 

00035584 000453A8 00035438 00035584 

E8066084 0003CI5A E40355D4 0403CI58 
00035584 00035423 00035438 00035584 
E405D000 000408EO 0F036F38 0A0408D8 

NOTE: If this is a one-buffer message, Line End Appendage tposts 
the buffer to STARTMH QCB; otherwise, PCI would tpost 
the buffer when handling subsequent PCI interrupts. 

E4 05D000 0003F962 0F 036F38 0403F960 
DF05D000 000404CC C90404C0 060404C8 

NOTE: IEDQBD has 2 entry points. If C9 is in the QCB address, 
the buffers are being processed by the first entry point 
code of IEDQBD. 

E405D060 00 03C3I8 020355E0 0403C3I6 
E4 05D000 00057B5A 62038B70 0E038B78 

NOTE: The Send Scheduler is the first STCB in the STCB chain, 
signifying this destination awaits a full message. 

E405D000 00 03DCF6 62038B70 0803DCF0 

E405D000 0003A772 02035634 0403A770 
E4059580 0003C3I8 020355E0 0403C3I6 

E0066084 000404CC C90404C0 060404C8 

E8035640 0003AD02 02035640 0403AD00 
E 3066038 00040704 I00406F8 06040700 

E0066038 00057082 00066038 0C066040 



Figure 49. A Receive, A Negative Response to Polling, and a Send Operation (Part 2 of 3) 
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NEGATIVE RESPONSE TO POLLING 

The LCB is tposted to itself signifying that the line is free. 

LCB Receive Scheduler passes the ERB to Buffer management, IEDQGA, to request 
buffers . 

IEDQGA gets buffers, completes them, and tposts the ERB to Activate, IEDQKA, 
to poll the line. 

WAIT issued by the dispatcher - waiting for an I/O interrupt. You may not see 
this if heavy line traffic. Only one line in this example. 

Line End tposts the LCB to Buffer Disposition on a negative response to polling. 
E7 priority in LCB equals a negative response situation. 

BD will free buffers by tposting the buffer to GB. This will only happen at the end 
of the invitation list if this is a multipoint line. 

BD will branch to do INMSG macro processing. The parameter list in the SCB will 
have the macros that are used in INMSG processing. At INEND the LCB is tposted 
to BD for finishing the line activity. 

BD will tpost the LCB to itself. This designates that the line is again free. 



E0066038 00057082 00066038 0C066040 

E4066084 0003CI5A E40355D4 0403CI58 

E4066084 0003C722 02035610 0403C720 

00035584 0003C722 00035438 00035584 

E7066038 000404CC C90404C0 060404C8 

E405CB20 0003C3I8 020355E0 0403C3I6 

E3066038 00040704 I00406F8 06040700 

NOTE: No actual INMSG processing is done. Control is passed 
through the macros to INEND. 

E0066038 00057082 00066038 0C066040 



SEND OPERATION TO A TERMINAL 

Receive Scheduler in LCB tposted to itself. 

Receive Scheduler gives control to the Send Scheduler by DSPBYPAS. 

Send Scheduler tposts the ERB to CPB Initialization, IEDQFA, for Disk I/O to 

retrieve message from the queue. EA in ERB is an initial request for a Send. 

FA tposts the ERB with the count to IEDQKA. Message is read from the core queue. 



Activate, IEDQKA, starts addressing the line. A SIO is done with a Write Idle loop. 

Wait on same interrupt — either positive response to addressing or disk ending. 

Line End on positive response to addressing tposts buffer(s) filled by FA to the 
STARTMH QCB. IEDQBT EOB/ETB is the first subtask in the chain, as in receive 
open, indicates user logical error checking. 

BT bypasses to IEDQAA, which processes OUTHDR and OUTBUF macros. BALs to 
Buffer Association for CCW building. Not seen in trace as it does not go through 
dispatcher. 

Wait on buffer to finish being sent to the line. 

Buffer tposted by Line End Appendage to perform OUTMSG processing. Buffer has 
been sent to line and line interrupt has occurred. C9 signals EOM buffer. 
NOTE: 

PCI interrupt would occur if coded but is effective NOP on send if a one- 
buffer message or if initial request has enough buffers assigned to hold all 
the message. PCI can free any previously sent buffers but will not get any 
more if this is the case as in this send operation. 

At OUTEND BD will tpost the buffer to FA to write the message serviced flag in 

the queued record. 

EC in priority field is EOM buffer to be marked. 

At OUTEND, BD will also tpost the LCB to its second entry point to perform line- 
freeing activity. 

LCB is tposted to itself with Send Scheduler first in the subtask chain. The next 
message on this queue would be sent if any more were queued. When no more 
messages, the Send Scheduler will bypass to the Receive Scheduler to 
poll the line. This is a CPRI = E situation. 

LCB tposted to itself with the Receive Scheduler done by DSPBYPAS. 



E0066038 00057082 E4066038 0C066040 
E0066038 00057B5A 00066038 0E038B78 
E4066084 0003A772 02035634 0403A770 

NOTE: If no core queuing, FA would have done a SIO by EXCP 
Driver to get the message from the disk queue and Disk 
End Appendage would tpost the CPB Cleanup QCB to 
itself. Core queuing with disk backup is used in this 
example, thus no SIO. 

E4066084 0003C722 02035610 0403C720 
00035584 0003C722 00035438 00035584 
E4059580 000408E0 0F036F38 0A0408D8 



E4059580 0003F962 0F036F38 0403F960 

00035584 0003C3I8 00035438 00035584 
E4059580 000404CC C90404C0 060404C8 



EC059580 0003A772 02035634 0403A770 

E3066038 00040704 [00406F8 06040700 

E0066038 00057B5A E4066038 0E038B78 

E0066038 00057082 00066038 0C066040 



Figure 49. A Receive, a Negative Response to Polling, and a Send Operation (Part 3 of 3) 
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Buffer Trace 



The buffer trace dumps TCAM buffer contents and status to a sequential data set. 
You can only trace buffers for a line being traced by the line I/O interrupt trace. 

Activating the Trace: Whether this trace is available in your system depends on 
how you design your MCP. To include it, code on the INTRO macro instruction 
the operand COMWRTE=YES. The default is COMWRTE=NO. Include the 
operand at assembly time, or at INTRO execution time in response to the message 

. IED002A SPECIFY TCAM PARAMETERS 

that is generated only if you omit one of the following INTRO operands at 
assembly time: 

STARTUP=, LNUNITS=, KEYLEN=, and, if DISK=YES, CPB= . 

The response keyword is G= or COMWRTE=. If you specify YES, include a DD 
statement in your MCP execution deck to create the COMWRITE data set. You 
must also specify a positive value for the TRACE= operand of the INTRO macro, 
either at assembly or INTRO execution time. 

The trace table is internal to COMWRITE (an attached task), therefore, a dump 
of your MCP region does not contain the buffer trace table. The only way you 
can obtain the output of the buffer-trace table dump is to use the utility COMED- 
IT (IEDQXB). Activate the Buffer Trace routine by issuing the DEBUG operator 
command. 



control characters 



operation 



operand 



control chars 



JMODIF 



1{ 



[procname.]id\ , 
Ijobname / 



DEBUG=L,IEDQFE30 



This loads (L) the dump routine for the buffer trace. If you want to deactivate the 
routine, replace the L with D; otherwise, the command is the same. 

Example: Printing the buffer trace 

//PRINT JOB MSGLEVEL=1 

//STEP EXEC PGM=IEDQXB,PARM='BUFF' 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSN=COMWRITE,UNIT=2400,DISP=OLD,* 

// LABEL= ( , NL ) , VOL=SER=DUMMY 

/* 

The buffer trace table is also printed when no PARM= parameter is specified. 

Use the buffer trace to learn the status of a message as STARTMH receives it, 
both incoming and outgoing. This helps you determine where your problem is, 
since you know the status of the message before you do any processing (trouble in 
transmission) and the status after incoming processing (trouble in your message 
handler). Dump the buffer trace for all data-oriented problems, such as lost, 
erroneous, or extraneous data. Dump it also for all line or line-oriented problems. 

Using the Buffer Trace: The TCAM buffer trace table records buffer contents and 
status. Use this table to trace a message through your message handler. TCAM 
places an entry in the table as soon as it posts the buffer to STARTMH. Both 
header and text buffers are posted. 
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TCAM places an entry for an input buffer in the table before it does any message 
handling. Therefore, the buffer contents are in a hexadecimal format that repre- 
sents the line code of the originating terminal. Buffer contents include, in front of 
message data, the buffer prefix and the number of bytes you reserved in the 
RESERVE= operand of the line group DCB macro. Each trace entry is only 96 
bytes; therefore, if you have many reserve characters, the entry includes little or 
no message data. 

The buffer prefix contains only the number of units in the buffer, the address of 
the LCB of the originating terminal, the status byte, and the amount of data in the 
buffer. TCAM fills in the remainder of the prefix during message processing. 

By examining the input-buffer trace entry, you can learn the status of the buffer 
before any message handling. If you find an error, you have a problem either in 
the originating terminal or on the line over which the message was transmitted (a 
probable hardware error). 

TCAM places an entry for an output buffer in the table after incoming message 
processing is complete and before any output processing. The buffer is already on 
the queue for the destination terminal. If you find an error in the trace entry, you 
have a problem either in the incoming subgroup of your message handler or in the 
queuing activity of TCAM (a probable software error). 

Format of an Entry: The 96-byte buffer trace entry has the following format: 






4 


8 


12 


13 


14 


15 


Buffer 
Address 


SCB 

Flags 


Error CSW 


Sense 
Byte 


IOB 

Flagl 


IOB 

Flag3 


ERB 

Status 


LCB 

Status 


Line 
Address 


Buffer Prefix 
and Data 





16 



18 



20 



95 



Buffer address: The address of the buffer in main storage. The address of the 
input buffer and the output buffer may not be identical because of TCAM 
queuing. For example, if you send a message to a station with disk queuing, 
TCAM places the input buffer on the disk, and frees the buffer in main storage. 
When the buffer is ready to send to the destination, TCAM brings a copy of the 
buffer contents back into main storage to process in the outgoing message 
handler. This copy will probably not be in the same main-storage location as 
the input buffer. 

SCB error flags: The first four bytes of the message error record assigned to 
the message. 

CSW: The last half of the channel status word. It includes the status and 
count; each is two bytes. The two status bytes identify conditions in the device 
and channel. Bits through 7 indicate conditions detected by the device or 
control unit. Bits 8 through 15 indicate conditions associated with the subchan- 
nel. 
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Bit 


Meaning 


Bit 


Meaning 





attention 


8 


program-controlled 
interruption 


1 


status modifier 


9 


incorrect length 


2 


control unit end 


10 


program check 


3 


busy 


11 


protection check 


4 


channel end 


12 


channel data check 


5 


device end 


13 


channel control check 


6 


unit check 


14 


interface control check 


7 


unit exception 


15 


chaining check 



The two count bytes are the residual count for the last CCW used. See 
Principles of Operation, GA22-6821, for a complete discussion of the CSW 
and its bit settings. 

Sense byte: For a description of the contents of the sense byte, see the compo- 
nent description publication for the transmission control unit that you are using. 

IOB flag 1: The flag byte in the IOB with the following meanings: 



Bits 


Meaning 


00 


no chaining 


01 


command chaining 


10 


data chaining 


11 


both command and data chaining 


..1 


error routine in control 


...1 .... 


device is to be repositioned 


.... 1... 


cyclic redundancy check (CRC) needed - tape only 


1.. 


exceptional condition. After the error routine 




returns and this bit is on, the error is permanent 


1. 


IOB unrelated flag 





start 


1 


restart 



IOB flag 3: The I/O Supervisor routine flag byte. It is device dependent. 
See the I/O Supervisor PLM, for a description of this byte. 

ERB status: The element request block (ERB) status byte. The ERB is a 
control area used to request buffers for a line group. 

Meaning 

end of initiate mode 

end of message read from disk 

logical read error 

ERB is waiting for buffers 

can never be set — distinguishes buffer from ERB 

error on send side 

disk request is complete (temporary) 

delink switch. ERB is not tposted, but 

is eligible to be tposted 

LCB status: A two-byte field containing the status of the LCB. 

Bit Value Meaning 

X'80' recall is being performed 

1 X'40' line is in control mode or this is the 

first BSC output conversational block 



Bit 


Value 





X'80' 


1 


X'40' 


2 


X'20' 


3 


X'10' 


4 


X'08' 


5 


X'04' 


6 


X'02' 


7 


X'01' 
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3 


X'10' 


4 


X'08' 


5 


X'04' 


6 


X'02' 


7 


x'or 



12 


X'08' 


13 


X'04' 


14 


X'02' 


15 


x'or 



X'20' non-immediate operator control operation 
is in progress 

receiving an initiate-mode message 
continue or reset operation in progress 
line is free 
line is receiving 
line is sending 

If bits 5, 6, and 7 are off, the line is stopped. 

8 X'80' I/O trace is active for this line or the 
line is in lock mode 

X'7F' mask to specify the I/O trace is not 
active for this line 

9 X'40' MSGGEN or start-up message 
X'BF' mask to specify that this is not a MSGGEN 

or start-up message 

10 X'20' EOT from a buffered terminal, no EOM 
X'DF' mask to specify a regular EOM if not EOT 

from a buffered terminal 

11 X'10' send priority switch set by the send 
scheduler 

negative response to polling 
line is binary synchronous (BSC) 
this is a dial LCB 
a response needs to be sent to the line 

Line address: The hardware address of the line over which the message was 
transmitted. 

Buffer prefix and data: The remaining 76 bytes of the trace entry contain the 
buffer prefix, the reserved space you requested in the RESERVE= operand of 
the line group DCB macro, and the actual message data. Figure 50 shows the 
format of the buffer prefix. The bit definitions for the status byte 
(PRFSTAT1) are: 

Value Meaning 

X'80' message has been canceled 

X'40' this buffer contains an error message 

X'20' this message is being held 

X'10' this is a TSO buffer 

X'08' this is a duplicate-header buffer 

X'04' SETEOF was executed 

X'02' this is not the last buffer of the message 

X'01' this is not the first buffer of the message 

X'00' there is only one buffer in this message 

The Formatted Table: Figure 51 shows the buffer trace as formatted by the utility 
program IEDQXB. The meaning of each field follows. Figure 50, a buffer prefix, 
is for your reference. 

Buffer trace: The title of the dump. 
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Buffer Prefix 



o 

H 

n 
> 
2 



o 



First buffer of a message: 
Offset 






1 


4 


5 




8 


12(C) 


13(D) 


16(10) 


18(12) 


20(14) 


21 (15) 


24 (18) 


26 (1A) 


29 (1D) 


32 (20) 


35 (23) 


38 (26) 


40 (28) 


Key 
PRFKEY 

or 


QCB address 
PRFQCBA 

or 

Next 
address 


Priority 
PRFPRI 

or 


Link field 
PRFLINK 

CCW 


Link to 
next 
unit and 
TIC CCW 


Number 
of units 
in this 
buffer 


LCB 
address 


Source 
offset 
in the 
Termname 
Table 


Size of 
data in 
this 
buffer 


Status 
byte 


Pointer to 
additional 
records on 
disk 

PRFXTRA 
or to the 


Scan 

pointer 

offset 


Pointer to 
next buffer 
of this 
message if 
not last 
buffer 


Pointer 
to the 
first 
unit of 
the 
current 


Pointer 
to the 
first 
buffer 
of the 
next 


Queue-back 
chain of 
the first 
buffers of 
messages 


Input 

sequence 

number 


Destination 
offset 
in the 
Termname 
Table 


CCW OP 
Code 


to be 
transferred 


CCW 
flags 


Unused 
















current 
record in 
main storage 




PRFNTXT 

or text queue- 
back chain if 
last buffer 


buffer 


message 








PRFOPCDE 


PRFIOADR 


PRFFLAGS 




PRFCOUNT 


PRFTIC 


PRFNBUNT 


PR F LCB 


PRFSRCE 


PRFSIZE 


PRFSTAT1 


PRFCORE 


PRFSCAN 


PRFTQBCK 


PRFCRCD 


PRFNHDR PRFHQBCK 


PRFISEQ 


PRFDEST 






O^D 




















The first 12 bytes are not placed on the 

































queue for the message queues data set 



12(C) 



42 (2A) 



Unit control area 



First buffer prefix 
PRFSUNIT 



Start of the message header or data 
PRFSHDR 



Subsequent buffer of a message: 
Offset 






1 


4 


5 




8 


12(C) 


13(D) 


16(10) 


18(12) 


20(14) 


21 (15) 


24(18) 


26 (1A) 


29(10) 


32 (20) 


Key 


QCB address 


Priority 


Link field 


Link to 


Number 


LCB 


Source 


Size of 


Status 


Pointer to 


Scan 


Pointer to 


Pointer 


Pointer 


PRFKEY 


PRFQCBA 


PRFPRI 


PRFLINK 


next 


of units 


address 


offset 


data in 


byte 


additional 


pointer 


next buffer 


to the 


to the 










unit and 


in this 




in the 


this 




records on 


offset 


of this 


first 


first 










TIC CCW 


buffer 




Termname 


buffer 




disk 




message if 


unit of 


buffer 


or 


Next 


or 










Table 






PRFXTRA 




not last 


the 


of the 




address 






CCW 














or to the 




buffer 


current 


current 


CCW OP 


to be 


CCW 


Unused 


count 














current 




PRFNTXT 


buffer 


message 


Code 


transferred 


flags 


















record in 
main storage 




or text queue- 
back chain if 
last buffer 






PRFOPCDE 


PRFIOADR 


PRFFLAGS 




PRFCOUNT 


PRFTIC 


PRFNBUNT 


PR F LCB 


PRFSRCE 


PRFSIZE 


PRFSTAT1 


PRFCORE 


PRFSCAN 


PRFTQBCK 


PRFCRCK 


PRFCHDR 
















1 


he first 12 bytes are not placed on the 














q 


ueue for the message queues data set. ^_^«--""' 













1 


2(0-^"^ 






35(23 


_ 





















Unit control area 


Subsequent buffer prefix 
PRFSUNIT 


Continuation of message header or start or 
continuation of message data 

PRFSTXT 



, START OF BUFFER PREFIX 
♦♦BUFFER TRACE** SEQUENCE- 00000 l.-._JU_FFl _ _ L_ _ _ _ DATE- 71.292 TIME- 09.07. 59 

__^ © © ® GXimv, , © ® 1© © ® © 

INPUT " ^ lOOCtCOOfl OOOOOOOOl 0040004F||00|C6k)0|oi| |028C|001S| 02|077058| 0000|0059| 00|C00000 gparp RPSFRVFP FY * 

BUFFER OOOOCOOC 00000000 06DA6000 OOOCOOOO 0018I000C 90909001 01A6E7E2 C901D2A9 RESERVE = OPERAND ON DCB XSI.K.* 

CACAF3CA EEP10190 90K)1| 2F01 70293167 45010201 6B2A6B52 31016B2A 6B523101 *..3 * 

E4C«CB8C 00000000 OOOMnnj flnf'nnt I "' * n " n ' 7 0206A268 00120059 0806DEE0 *U B * 

4DCF000C 0006DEE0 06DEE§Ir R J-il F - !1 E ? SA . G .^ _ D , A , T *.' 90909001 01A6E7E2 C901D2A9 * XSI.K.* 

CAE740C6 E4E8C302 40F140FO F94BF0F7 4BF2F24C C5E5C5D9 E840C5E5 C509E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

E406CE20 00000000 00000000 00C20041 018C0012 0206A1AC 00120059 O8C60AC0 *U B * 

4D0FC00C 0006DACC 060AC000 00000001 OC040000 90909001 01A6E7E2 C9C1C2A9 * XSI.K.* 

CAE740C6 E4E8C3D2 40F140FO F94BF0F7 4BF2F240 C5E5C5D9 E840C5E5 C509E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

E4C<CB80 OOOOOOCO 00000000 00C20041 018000TSTART OF BUFFER PREFIX C8C6E6C0 *U B H.* 

4DCFCC0C 0006F6C0 06E6C000 00000001 OOOBOdOC 90909001 01A6E7E2 C90102A9 * W..W XSI.K.* 

CAE©CC8 E4£©3D2 40F®0F0 ©®©@ A®2®W ©E^|>D9 (®0C©5 ©C9E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

OUTPUT " — ► IE406CE20I 000000001 OOOOOOOOl |00lC2|00MI |G 180100 12T02|06A1AQ| 0012|OC59l 08JC6E720 *U B X.* 

BUFFER (6 H40CFIC00C 0006E720 06E72C00 00000001 OOOqOOOC 90909001 01A6E7E2 C901C2A9 RESERVE BYTES XSI.K.* 

CAIE740C8 E4E8C3D2 40F140F0 F94BF0F7 4®2F240 C5E5C5D9 E840C5E5 C5D9E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

CC0V/' e °'l T n 7, o _ n j\ , l"'l ArF'nATA 1 OOC60001 0>b00015 02077058 00000077 OOOOOCOO * F * 

OCOCOuuu uuuuuiSSu uuwvuouO 00000000 0018000C 5C5C5C40 40E3C3C1 D440D9E4 * TCAM RU* 

D5C5C905 C740405C 5C012F01 70293167 45010401 49625231 014A3167 01622646 *NNING * 

E4C6E6C0 OOOOOOCO COOOCOOO 00C20041 01800012 0206A1A0 00120C77 08C6CAC0 *U.W B * 

5BOF0O0C 0006DAC0 06DAC000 00000002 0004000C 5C5C5C40 40E3C3C1 D440C9E4 * TCAM RU* 

D5E740C8 E4E8C3D2 40F240F0 F94BF0F7 4BF4F740 D4C1D9E8 40D5E8C3 40C1E3D3 *NX HUYCK 2 09. 07.47 MARY NYC ATL* 

E4060EE0 00000000 00000000 00C20041 01800017 0206A268 00120077 08C6E720 *U B ..X.* 

5E0FC00C 0006E720 06E72000 00000002 OOOBCOOO 5C5C5C4C 40E3C3C1 D44009E4 * X..X TCAM RU* 

D5E740C8 E4E8C3D2 40F240F0 F94BF0F7 4BF4F740 D4C1D9E8 40D5E8C3 40C1E3D3 *NX HUYCK 2 09.07.47 MARY NYC ATL* 

CCC6E120 00000000 00000000 00C20041 01800015 02077058 00120059 C8C6DBE0 * B * 

4D0F0C00 0006DBE0 06DBE000 00000001 0012COOO 90909C01 01A6E7E2 C9C102A9 * XSI.K.* 

CAE740C6 E4E8C3D2 40F140F0 F94BF0F7 4BF2F240 C5E5C5D9 E840C5E5 C5C9E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

C006E120 00000000 00000000 00C20041 01800015 02077058 00120059 0806DFA0 * B * 

4D0FC00C 0006DFA0 C6DFA000 000C0C01 0018000C 90909001 01A6E7E2 C9C1D2A9 * XSI.K.* 

CAE740C8 E4E8C302 40F140F0 F94BF0F7 4BF2F240 C5E5C5D9 E840C5E5 C5C9E840 *.X HUYCK 1 09.07.22 EVERY EVERY * 

Figure 5 1 . Formatted Buffer Trace 

Sequence: A sequential count of the number of buffer trace tables printed. It is 
incremented by one each time a table is filled. If a number is skipped, you have 
lost records. Once a table is filled, the buffer trace dump routine increments 
the sequence count and gives the table to COMWRITE for writing. If this 
routine is busy, the table wraps, and entries are lost. The sequence field shows 
this internal wrapping. 

Buffi : The first of the two trace tables is being dumped. This field alternates 
between BUFFI and BUFF2. The buffer-trace dump routine fills one of the 
tables while the other is being placed on the data set. 



Time and date field: 

set. 

Input buffer: 



The time and date the trace table was placed on the data 



1. 

2. 
3. 

4. 
5. 

6. 

7. 



9. 
10. 



Main-storage address is 06DD00. 

No error bits are on in the message error record. 

The CSW control unit status (0D40) is channel end, device end, unit 

exception, and a residual count X'4F' or 79 bytes. 

The sense byte for the control unit is 00. 

IOB FLAG1 is C6, indicating both command and data chaining and an 

exceptional condition (permanent error). 

IOB FLAG3 contains no information. 

ERB status is 01. The ERB is not tposted but is eligible to be tposted. 

LCB status is 0280. The line is receiving and the I/O trace is active for 

this line. 

The originating terminal is on line 0015. 

The next 30 bytes are the buffer prefix. It contains the following 

information. 



1 . Two units are in the buffer. 

2. The LCB address for the originating station in 077058. 

3. The size of the data in the buffer is X'59', or 89 bytes. 

4. The status byte contains 00, indicating that only one buffer is in this 
message. 

On the DCB for this line, the RESERVE= operand has a value of 24. There- 
fore, the next 24 bytes are reserved, and at present contain no valid data. 
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Cross-Reference Table 



The message is in line code. The terminal entering the message is a 1050. By 
examining the line code chart for the 1050 terminal in the TCAM 
Programmer's Guide, you can translate the message contents. 



Byte 


Translation 


2F 


X 


01 


space 


70 


H 


29 


U 


31 


Y 


67 


C 


45 


K 


etc. 





Output buffer: There are several entries for output buffers, since one of the 
destinations in the input buffer is a distribution list. The output buffers are 
easy to find since they are translated into EBCDIC. This example shows one of 
the output buffer entries. 

1 . The main-storage address for the output buffer to this terminal is 6DE20. 
It is not the same as the input buffer location. 

2. No SCB error bit flags are set, so the message is still correct. 

3. There is no CSW information. 

4. The sense byte for the control unit is 00. 

5. IOB FLAG1 is C2, indicating both command and data chaining. 

6. IOB FLAG3 is 00. 

7. The ERB status is 41, indicating that end of message was read from disk 
and that the ERB is not tposted but is eligible to be tposted. 

8. The LCB status is 0180, indicating that the line is receiving and that an 
I/O trace is active for this line. 

9. The address of the receiving terminal is 0012. 

The next 30 bytes are the buffer prefix, which contains the following informa- 
tion. 

1 . Two units are in the buffer. 

2. The LCB address for the receiving terminal is 06A1 A0. 

3. Alphabetically, the originating terminal is the eighteenth terminal in the 
termname table (HUYCK). 

4. The size of the data in the buffer is X'59', or 89 bytes. 

5. The status is 08, indicating that this is a duplicate-header buffer. 

6. The scan pointer is located at X'4D' from the beginning of the prefix. 
The X'OF' in the scan pointer field indicates that 15 reserve bytes are still 
left in the buffer. Nine of the original 24 reserve bytes were used to insert 
the time. 

7. Alphabetically, the receiving terminal is the fourth terminal in the term- 
name table. 

The next 15 bytes are the reserve bytes; they contain no valid data. Following 
the reserve bytes is the EBCDIC translation of the message contents. 



The TCAM cross-reference table contains the locations of all opened lines in your 
system and pointers to the major control blocks for each line. A formatted listing 
of this table is not available. If you include the table in your system, entries are 
created in it for each open line. Use it primarily as a quick reference, after system 
failure, to locate control blocks in a TCAM dump. 
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The TCAM cross-reference table is a convenient way to locate, in a dump, 
information for each open line. TCAM builds the cross-reference table if you 
code a positive integer in the CROSSRF= operand of the INTRO macro instruc- 
tion. 

At INTRO execution time, TCAM allocates 16n+8 contiguous bytes of main 
storage, where n is the integer specified in the CROSSRF= operand, and eight 
bytes is the length of the control block preceding the first entry for the table. 
AVT+X'200' contains the address of the table. Each time a line is opened, 
TCAM fills in the next available four-word entry in the table for that line. 

The eight-byte control block preceding the first entry and the format of each entry 
is shown in Figure 52. 

If you queue by line, only one master queue control block is assigned to the line, 
and TCAM places its address in the fourth word. If you queue by terminal, a 
master queue control block is assigned to each station on the line; in this instance, 
TCAM fills the fourth word with the address of the queue control block for the 
station whose entry appears in the terminal table before that of any other station 
on the line. If you open more lines than you provide entries for in the table, 
entries are made until the space is exhausted; no entries are made for lines opened 
after space runs out in the table. 

If space permits, you should dynamically include the table at start-up time, 
specifying, CROSSRF=n or F=n where n is the number of lines to be opened. 



AVT 



+ X'200' 



4 



FORMAT OF THE CROSS-REFERENCE TABLE CONTROL BLOCK 



BYTE 


EXPLANATION 





ADDRESS OF FIRST AVAILABLE ENTRY 
I i i 


+4 


ADDRESS OF LAST ENTRY 

1 1 1 



FORMAT OF CROSS-REFERENCE TABLE ENTRY 



BYTE 



EXPLANATION 



UNIT CONTROL BLOCK NAME 
I I L 



+4 



UNIT CONTROL BLOCK ADDRESS 
I I L 



+8 



LINE CONTROL BLOCK ADDRESS 
I I L 



+12 



ADDRESS OF A MASTER QUEUE CONTROL 
BLOCK FOR THIS LINE 



Figure 52. Cross-Reference Table Format 
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The information in the table is a ready reference for each UCB. You will find this 
information especially helpful in the test/diagnose stages of implementing TCAM; 
it is a fast way to find out which line is using which UCB and where the QCB for a 
line is. It also shows which lines have been opened successfully. Figure 53 shows 
the printout of a cross-reference table in a main-storage dump. 



AVT 



X 



+ 512(200) 



060F20 



-c_ 



_r 



060E60 
060E80 
060EA0 
060EC0 
060EE0 
060FOO 
060F20 
360F40 
060F60 



801080C6 96F08011 0C16000F 0018000B 00170010 00130019\inRST ,or,Anni2 * * 

002700C5 C00100C3 00140007 00150Q2C 0022001B 00240008 TAVAILABLElC LAST)*, * * 

OC09001C 001D001E 0C1F0021 0023001A 0O0D0025 00261055 |00060F20 |0QC60FA0| * * 

00F0F1F5 80001458 C2060C40 00026998 O0FOF1F1 800013F8 (CONTROL O'BLOCK'C *.015 Oil. ..8 * 

I00F0F1F7 180001488 |0 2060A10 I00026A20 I 00F0F1F2 80001410 OZ060V4B C0U26A64 *.017 012 * 

UCB LCB MASTER 00F0F1C1 800014D0 02057128 00026B30 *.018 01A * 

ADDRESS ADDRESS QCB ADDRESS 00060F40 00000000 00000000 00C00000 * * 

uuuuuuuu uuuuuuuu uuuuuuuu 0006CF60 00000000 00000000 00C00C0C *..... ...•..................* 

00000000 00000000 00000000 00060F80 00000000 00000000 ooooocoo * * 



0C UCB ° 
oc NAME 10 

O0ut)Uf30 
OC060F70 



Figure 53. A Cross-Reference Table 

Console and Terminal Listings 

Have the system console listing available before you start any debugging. It 
contains a great deal of information about the system activities while TCAM is 
running, including the IEA000I error messages when permanent I/O errors occur. 
These messages can help you determine if your problem lies in the hardware of the 
line or the terminal. 

In an ideal situation, you will also have all remote terminal listings when you start 
to debug a problem. Sometimes this is not possible. However, you should always 
have some remote terminal listings. 

If you specified a terminal other than SYSCON, the system console, on the 
PRIMARY= operand of the INTRO macro, have the terminal listing for that 
terminal. All IEA000I error messages will be on this listing. You also need the 
terminal listing from every secondary terminal (a terminal for which you specified 
SECTERM=YES in its TERMINAL macro). These terminals can enter operator 
commands that allow them to reconfigure the network as they desire. An unex- 
pected operator command can impact the entire system, and you may not have 
any idea why the system failed. Finally, you need terminal listings When there is 
any data or line problem. 

When you collect the listings, mark the terminal name and type on the listings to 
make it easier to locate the LCB for the terminal in error. 

Remember, for all problems, you should have: 

1 . the system console listing, 

2. the primary terminal listing (if it is not the console), and 

3. all secondary terminal listings. 

Using Operator Commands 

Using the TCAM operator control facility, you can enter operator commands to 
examine or alter the status of your telecommunications network. You can enter 
these commands from: 
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1. the system console; 

2. a system input device (you must place the JCL identification // in the first two 
positions); or 

3. any station or application program you designate as a secondary terminal (by 
coding SECTERM=YES on the TERMINAL or TPROCESS macro). 

When you enter a command from a secondary station, remember: 

1 . you must precede the command with the characters specified in the 
CONTROL= operand of the INTRO macro instruction; and 

2. you must follow the command with one or more blanks. 

Figure 54 is a quick-reference chart of the TCAM operator commands and their 
functions. 

Notes: 

lineaddress may be entered either as the channel unit address or as 
ddnamej In where ddname is the name of the line group as specified on the 
DD statement and rln is the relative line number in the group. 

statname is the specific station for which information or change is desired. 
It must correspond to the name of a TERMINAL macro and may be from 
one to eight characters beginning with an alphabetic character. 

opfldname is the name of the specific option field, as specified in an 
OPTION macro for which information or change is desired. It may be 
from one to eight characters beginning with an alphabetic character. 

procname is the name of the TCAM cataloged procedure in 
SYS1.PROCLIB. 

id is the TCAM identifier used in the START command or the name of 
the job used to start TCAM in the system input stream. 

jobname is identical to the jobname field in the JOB statement for the job. 

Note 1: The sense field may be any one of the following: 

BO bus-out check 

CR command reject 

DC data check 

EC equipment check 

IM general intensive mode 

IR intervention required 

LD lost data 

M2 leading graphics for 2740 Model 2 terminal 

OR overrun 

TO time-out 

UE unit exception 
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TYPE OF KEYWORD 
OPERATION NAME 



COMMAND 



AREAS 
AFFECTED 



FUNCTION 



DISPLAY DPRIOPCL 



D TP, PRITERM 



system, 
station 



Displays the name of the current primary 
operator control station. 



DSECOPCL 



DTP, SECTERM 



system, 
station 



Displays the names of all secondary operator 
control stations. 



INTRCEPT 



DTP, INTER 



system, 
station 



Displays the names of all stations in the 
network that are intercepted (that is, stations 
that can enter messages but to which 
transmission of messages is suspended). 



ACTVATED 



D TP, ACT, lineaddress 



line, 
station 



Displays the names of all active stations on 
the line addressed. 



INACTVTD 



DTP, INACT, lineaddress 



ne, 
station 



Displays the names of all inactive stations on 
the line addressed. 



LN STATUS 



D TP, LINE, lineaddress 



Displays the status field and error record for 
the line (see Note 2). 



QSTATUS 



D TP, QUEUE, statname 



line, 
station 



Displays the queue control block for the 
station; the information includes the number 
of messages queued, the queue status, and the 
priority levels permitted for messages. 



STATDISP 



D TP, LIST, lineaddress 



line, 
station 



Displays whether the invitation list for the 
line may be polled and whether the Auto Poll 
feature is being used to poll the list. 



OPTFIhLD 



D TP, OPTION, statname, opfldname, f>A 



station 



Displays the contents of the field that is 
reserved in the option table for the station. 
X is hexadecimal format; C, character 
format; D, decimal format. 



RLNSTATN 



D TP, ADDR, statname 



station 



Displays the name of the line group of which 
the station is a part, the relative line number 
of the line on which the station is located, 
and the machine address of the line. 



STSTATUS 



D TP, TERM, statname 



Displays the status, input and output sequence 
numbers, and current intensive-mode record- 
ing status for the station. 



HALT 



SYSCLOSE 



Z TP, QUICK 



Z TP, FLUSH 



system 



Stops message traffic on each line as soon as 
transmission of any message currently being 
sent or received on the line is completed. 
Messages remaining in the system are sent to 
the appropriate destinations after TCAM is 
restarted. 



system 



Stops message transmission from stations as 
soon as transmission of any message currently 
being sent is completed. All messages to 
stations are then sent before the system is 
halted. Intercepted messages that cannot be 
sent to stations are sent to the appropriate 
destination after TCAM is restarted. 



HOLD 



SUSPXMIT 



H TP=statname 



Suspends transmission to the station named. 
The station is intercepted, but can enter 
messages. 



MODIFY 



CPRIOPCL 



F f[procname.] id"\ , OPERATOR=statname 
\ jobname J 



system, 
station 



Changes the secondary operator control station 
specified to the primary operator control 
station. 



ERRECORD 



F C [procname.] idl , 
\ jobname J 



INTENSE=LINE, lineaddress, sense [, sensecount] 
(See Note 1) 



system, 
station, 
line 



Records recoverable I/O errors occurring on 
the line specified by lineaddress. Sensecount 
is the number of times error recording is to 
take place; default is 15. 



F J [procname.] id^ , 
\ jobname J 



INTENSE=TERM, statname, sense f, sensecount] 
(See Note 1) 



system, 
station 



Records recoverable I/O errors occurring on 
the station specified. Sensecount is the 
number of times error recording is to take 
place; default is 15. 



Figure 54. Summary of Operator Commands (Part 1 of 2) 
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TYPE OF KEYWORD 
OPERATION NAME COMMAND 



AREAS 
AFFECTED 



FUNCTION 



MODIFY 


INTERVAL 


F j"[procname.] id V INTERVAL=SYSTEM 
| jobname J 


system, 
line 


Causes the system to enter a delay for the 
duration specified on the INTVAL= operand 
of the INTRO macro. 




SYSINTVL 


F f [procname.] id 1, INTERVAL=SYSTEM, value 
1 jobname / 


system 


Changes the duration of the system interval 
to the value specified. Value is a decimal 
number of seconds not exceeding 65535. 




POLLDLAY 


F f [procname.] id "^ , INTERVAL=POLL, statname, value 
\ jobname J 


line 


Changes the polling interval of the line group 
Statname is the name of any station in the 
line group to be changed. Replace value 
with the decimal number of seconds less than 
255. 




AUTOSTRT 


F ("[procname.] id "'I , AUTOPOLL=lineaddress, ON 
\ jobname J 


line 


Changes the line from programmed poll to the 
Auto Poll facility if the automatic polling bit 
is on in the UCB for the line. 




AUTOSTOP 


F f*[procname.] id *1 , AUTOPOLL=lineaddress, OFF 
\ jobname J 


line 


Changes the line from automatic polling to 
programmed polling. 




DATOPFLD 


F J [procname.] id ^ , OPT=statname, opfldname, data 
| jobname J 


station 


Changes the contents of the option field for a 
station. Opfldname is the option field to be 
changed. Data is the data to be inserted. 




GOTRACE 


F J [procname.] id | ,TRACE=lineaddress, ON 
\ jobname J 


line 


Starts the TCAM I/O trace facility for the 
line. 




NOTRACE 


F J [procname.] id ^ ,TRACE=lineaddress, OFF 
\ jobname J 


line 


Deactivates the TCAM I/O trace facility for 
the line. 




DEBUG 


F f[procname.] id^l ,DEBUG=L, routine 
\ jobname J 


system 


Starts the TCAM service aid routine that 
writes the dispatcher subtask trace table 
(IEDQFE10 is the routine), the I/O interrupt 
trace table (IEDQFE20), or the buffer trace 
(IEDQFE30). 


RELEASE 


RESMXMIT 


A TP=statname 


station 


Releases the intercepted station so that 
messages can be transmitted to the station 
specified or for the line on which the station 
is located. 


VARY 


ACTVBOTH 


V statname, ONTP, B 

(See Note 3) 


station 


Activates the nonswitched station named for 
both accepting and entering messages. 




ENTERING 


V statname, ONTP, E 

(See Note 3) 


station 


Activates the nonswitched station specified 
for entering messages only. 




NOENTRNG 


V statname, OFFTP, E 

(See Note 3) 


station 


Prevents the nonswitched station specified 
from entering messages. 




NOTRAFIC 


V statname, OFFTP, B 

(See Note 3) 


station 


Prevents the nonswitched station specified 
from both entering and receiving messages. 




STARTLINE 


Vlineaddress, ONTP 


line 


Begins or resumes transmission on the line 
specified. Lineaddress may specify either for 
a line or for the entire line group. 




STOPLINE 


V lineaddress, OFFTP, C 


line 


Stops transmission of messages on the line or 
line group specified after the current message. 




V lineaddress, OFFTP, 1 


line 


Immediately stops transmission of messages on 
the line or line group specified. 



Figure 54. Summary of Operator Commands (Part 2 of 2) 
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Note 2: Possible responses in the LNSTAT= field of the response message are: 

BS binary synchronous line 

CM line in control mode 

CR continue or reset operation 

DL switched (dial) line 

IM receiving initiate mode message 

LF line is free 

MS MSGGEN/start-up message 

NR negative response to polling 

OC operator control is stopping this line 

RC recall is being performed 

RV line is in receive mode 

SD line is in send mode 

TB EOT from a buffered terminal 

TR I/O trace active 

NO BITS ON 



Possible responses in the ERR = field of the response message are: 

ABR abort — BSC line 

CDC connect/disconnect error 

CHR channel error 

CUR control unit error 

CUT CUTOFF error 

FMT format error 

FWD FORWARD error 

HDR incomplete header 

HDW hardware error 

INV invalid ID from station 

ISB insufficient buffers 

LER line error 

LST. message lost (overlaid) 

MAX main-storage maximum passed 

MIN main-storage minimum passed 

MNS message not sent/received 

NOP station inoperative 

NTS TSO not in the system 

OLT on-line test not in the system 

ORG invalid origin 

SEL selection error 

SQH sequence number is high 

SQL sequence number is low 

TER terminal error 

TXT text transfer error 

UNR undefined error 

UNX unit exception 

USE user error 

NO BITS ON 

Note 3: You must issue a -STOPLINE command to stop the line before you 
enter this command, and, after receiving the response for the command, you 
must issue a START LINE command. 
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Normal End-of-Day Closedown 

Dump the TCAM data sets at the end of the day, since they contain important 
information about your system. The best way to handle your end-of-day cleanup 
is to place a procedure in SYS1.PROCLIB that dumps all necessary information. 

You then have to start only that one procedure, rather than try to remember all 
the things you want to dump. 

The following sample JCL creates an end-of-day procedure that dumps the 
nonreusable disk message queue, the reusable disk message queue, 
SYS1.LOGREC (the OBR/SDR data set), the log segment data set, and the 
COMWRITE data set. If you have experienced trouble during the day's execu- 
tion, you should dump this output to the printer. However, if you are only dump- 
ing those data sets to keep a history of the system, you should dump to an output 
tape. 

//PROC JOB MSGLEVEL=1 

//STEP EXEC PGM=IEBUPDTE 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS1 . PROCLIB, DISP=OLD 

//SYSUT2 DD DSNAME=SYS1 .PROCLIB, DISP=OLD 

//SYSIN DD DATA 

./ ADD LIST=ALL,NAME=ENDOFDAY,LEVEL=01 ,SOURCE=0 

.'/ NUMBER NEW1=1000,INCR=1000 

//STEP1 EXEC PGM=IEDQXC,PARM='Q=010,ALL' 

//DISKQ01 DD DSN=SAMP1 ,DISP=SHR 

//SYSPRINT DD SYSOUT=A 

//STEP2 EXEC PGM=IEDQXC,PARM='Q=010,ALL I 

//DISKQ01 DD DSN=REUSABLE,DISP=SHR 

//SYSPRINT DD SYSOUT=A 

//STEP3 EXEC PGM=IFCEREP0,PARM=(MCOS,PS) 

//SERLOG DD DSNAME=SYS 1 . LOGREC, DISP=OLD, UNIT=23 1 1 , * 

// VOL=SER=DT1010 

//EREPPT DD SYSOUT=A 

//STEP4 EXEC PGM=IEDQXB 

//SYSUT1 DD DSN=LOGSEG,VOL=SER=1 1 1 1 1 1 ,UNIT=231 1 , * 

// DISP=OLD 

//SYSPRINT DD SYSOUT=A 

//STEP5 EXEC PGM=IEDQXB 

//SYSUT1 DD DSN=COMWRITE,UNIT=2400,DISP=OLD, * 

// LABEL=( , NL ) , VOL=SER=THANKS 

//SYSPRINT DD SYSOUT=A 

./ ENDUP 

When you code this procedure: 

1. You cannot include any step that requires a DD * or DD DATA statement (that 
is, you cannot include a utility that requires control statements); and 

2. Each step has a space allocation. If you have trouble getting your output, 
either place a SPACE= parameter on each SYSPRINT statement, or allocate 
the SYSPRINT data set directly to the desired device. 

After you close TCAM, issue the following commands for the system console: 

Z EOD 

S ENDOFDAY 

The Z EOD command places an end-of-day marker in the SYS1. LOGREC data 
set. The START command starts the dumping procedure. 
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Figure 56. TCAM Control Block Linkages Between an Application Program and the MCP 
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Address Vector Table 



I/O Trace Table 



328(148) 

368(170) 
372(174) 
376(178) 
380(1 7C) 

388(184) 
392(188) 

412(19C) 

420(1A4) 
424(1A8) 

492(1 EC) 
496(1 F0) 
500(1 F4) 
512(200) 
720(2D0) 

900(384) 

1152(480) 

1176(498) 




4(4) 
8(8) 
12(C) 



12(C) 





AVTCSTCS f Device Characteristics Table 




AVTTCB A MCP TCB 


AVTRACE | I/O Trace Table 


AVTREADY Enabled Ready Queue 


AVTREADD Disabled Ready Queue 




AVTCKGET 4 Checkpoint Work Area 


AVTOCGET 4 Operator Control AVT 




AVTBASE 4 AVT 




AVTDISTR | Subtask Trace Table 


AVTRNMPT 4 ' Termname Table 




AVTOSECB OS TCAM ECB 


AVTPCBPT 4 First PCB 


AVTOPTPT 4 Option Table 


A Cross - Reference Table 


AVTADBUF 4 Buffer currently being processed 




AVTCOREC 4 Buffer-Unit Pool 




AVTADEBR 4 Reusable Disk DEB 




AVTADEBN J Nonreusable Disk DEB 






Control Block 



Start of Entries 



ZZ Repeated for Each Entry 



JT 



Subtask Trace Table 



t 



Next Entry 



4 First Entry 



A Last Entry 



Length of Table 



First Entry 



-p Repeated for each entry 



Line Control Block 




/ ° 


LCBRCB 


Resource Control Block 


/ 24(18) 


LCBSCBD 
Offset to 
currect SCB 


LCBSCBDA TSCB Directory 


I/O Block 




32(20) 




Sense Bytes 


36(24) 


Completion 
Code 


LCBECBPT j ECB 
lOBRCBPT | 






48(30) 




LCBSTART A Channel 
IOBSTART 1 Program 


52(34) 




LCBDCBPT 4 nrR 
lOBDCBPT 1 






96(60) 




A Current 
LCBINVPT | Invitation 
List Entry 



Destination QCB 








QCBELCHN 4 Element 
1 Chain 






8(8) 




QCBSTCHN 4 STCB Chain 






32(20) 




QCBDCBAD A DCB or PCB 






40(28) 


Start of Priority QCB 



Figure 57. Linkages of TCAM Diagnostic Aids 
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Appendix B. TCAM Macro Operand Summary 



The following figures (58-63) summarize the TCAM macros. They include the 
macros defining terminal and line control (Figure 58, three parts), the macros 
defining MCP data sets (Figure 59, three parts), the macros for activation and 
deactivation (Figure 60, five parts), the MH macros (Figure 61, 10 parts), the 
application program macros (Figure 62, seven parts), and other TCAM macros 
(Figure 63). 

The abbreviations used in these figures are: 

Abbreviation Meaning 

SYM Any symbol valid in the assembler language. 

DEC DIG Any decimal digits, up to the value indicated in the 

associated macro description. 
REG A general register, always coded within parentheses. 

RX-TYPE Any address that is valid in an RX-type instruction. 

A-TYPE ADCON Any address that may be written in an A-type address 

constant. 
HEX DIG Any hexadecimal digits, up to the value indicated in the 

associated macro description. 
CHARS Framed or unframed hexadecimal characters, up to the 

maximum indicated in the associated macro description. 

X indicates the appropriate column; for specific coding requirements, see the 
TCAM Programmer's Guide. 

Note: Defaults are underlined. 
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DEFINE INVITATION LIST 



symbol 


INVLIST 


ORDER = (statname+invchars,...) C, EOT = hexchar 3 
C, CPU ID = address 3 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


statname 


X 














+ 


+ or - 


invchars 












X 




EOT = 












X 




CPUID = 








X 









DEFINE A LOG ENTRY IN THE TERMINAL TABLE 



logname 


LOGTYPE 


dcbname, BUFSIZE = integer, QUEUES = form 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


dcbname 


X 














BUFSIZE = 




X 












QUEUES = 


MO, MR, MN, DR, or DN 



DEFINE AN OPTION FIELD 



symbol 


OPTION 


type length 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


type length 














X 



Figure 58. TCAM Macros Defining Terminal and Line Control (Part 1 of 3) 
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DEFINE A TERMINAL OR LINE ENTRY 



symbol 


TERMINAL 


QBY = T, DCB = dcbname, RLN = integer, TERM = type, 

QUEUES = form C , DIALNO = characters or DIALNO = NONE 3 

C , ADDR = characters 3 C, LEVEL = (integer, .. .)3 

C, CLOCK = time J C, CINTVL = integer J C , BUFSIZE = integer 3 

C , ALTDEST = symbol 3 C , BFDELAY = integer 3 L , TBLKSZ = integer 3 

C , NTBLKSZ = (integer, integer) 3 C , OPDATA = (data,. . .) 3 

C , SECTERM = YES or SECTERM =NO][, COMP = YES or COMP = NO 3 

[I , UTERM = YES or UTERM = NOD 



symbol 


TERMINAL 


QBY=L, DCB = dcbname, RLN = integer, TERM =type, 

QUEUES = form C, DIALNO = characters or DIALNO = NONE 3 

C, ADDR= characters!] C, LEVEL = (integer, .. .)3 

C, CLOCK = time 1 C, CINTVL = integer 3 C, BUFSIZE = integer 3 

C , ALTDEST = symbol 3L , BFDELAY = integer!] C , TBLKSZ = integer!] 

C , NTBLKSZ = (integer, integer)!] C , OPDATA = (data,...)!] 

[! . SECTERM = YES or SECTERM = NO 3 L , COMP = YES or COMP = NOD 

C , UTERM = YES or UTERM = NO!l 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


QBY = 


T or L 


DCBNAME = 


X 














RLN = 




X 












TERM = 














X 


QUEUES = 


MO, MR, MN, D 


R, or DN 










DIALNO = 




X 










X 


ADDR = 












X 




LEVEL = 




X 












CLOCK = 




X 












CINTVL = 




X 












BUFSIZE = 




X 












ALTDEST = 


X 














BFDELAY = 




X 












NTBLKSZ = 




X 












TBLKSZ = 




X 












OPDATA = 


X 


X 


X 


X 


X 


X 


X 


SECTERM - 


YES or NO 


COMP = 


YES or NO 


UTERM = 


YES or NO 



Figure 58. TCAM Macros Defining Terminal and Line Control (Part 2 of 3) 
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DEFINE A LIST ENTRY IN THE TERMINAL TABLE 



symbol 



TLIST 



TYPE= D, LIST = (entry,...) 



symbol 


TLIST 


TYPE=C, LIST = (entry,...) 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


TYPE = 


Dor C 


entry 


X 















DEFINE A PROCESS ENTRY 



symbol 


TPROCESS 


PCB = pcbname L" , QUEUES = form 1 Z , ALTDEST = entry!] 
C , CKPTSYN = YES or CKPTSYN = NO 3 C , RECDEL = hexcharD 
C, SECTERM = YES or SECTERM = NO 1 X , LEVEL = (integer, .. .)] 
L~, OPDATA= (data,...)D 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


PCB = 


X 














QUEUES = 


MO, MR, MN, DR, or DN 


ALTDEST = 


X 














CKPTSYN = 


YES or NO 


SECTERM = 


YES or NO 


RECDEL = 












X 




LEVEL = 




X 












OPDATA = 


X 


X 


0-15 


X 


X 


X 


X 



DEFINE TERMINAL TABLE BOUNDARIES 



[symbol] 


TTABLE 


LAST = statname L, MAXLEN = integer!] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


LAST = 


X 














MAXLEN = 




X 













Figure 58. TCAM Macros Defining Terminal and Line Control (Part 3 of 3) 
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DEFINE CHECKPOINT DATA CONTROL BLOCK 



ckptdcb 


DCB 


DSORG = TQ, MACRF = (G, P), DDNAME = ddname, OPTCD = C 
C, EXLST= address D 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


DSORG = 


TQ 


MACRF - 


(G,P) 


DDNAME - 


X 














OPTCD =■■ 


C 


EXLST - 








X 
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DEFINE LINE GROUP DATA CONTROL BLOCK 



linedcb 


DCB 


DSORG = TX, MACRF = (G, P), CPRI = R, DDNAME = ddname, 
MH = mhname, INVLIST = (listname I , B, B or B, A or A, B or A, A].....) 
C , INTVL = integer ] Z , EXLST = address] L" , BUFIN = integer or 
BUFIN = 1 ] L" , BUFOUT = integer or BUFOUT = 2] L" , BUFMAX = integer 
or BUFMAX = 2 ] C , BUFSIZE = integer!] L" , PCI = (N, N) or PCI = (R, A) 
or PCI = (A, N) or PCI = (A, R) or PCI = (A, A) ] L~ , RESERVE = (integer, 
integer) ] C , SCT = table] L" , TRANS = table or TRANS = EBCD ] 



linedcb 


DCB 


DSORG = TX, MACRF = (G, P) , CPRI = E, DDNAME = ddname, 
MH = mhname, INVLIST = (listname L\ B, B or B, A or A, B or A, AD,,...) 
C , INTVL = integer ] L" , EXLST = address] C , BUFIN = integer or 
BUFIN = 1 ] C , BUFOUT = integer or BUFOUT = 2] C , BUFMAX = integer 
or BUFMAX = 2 ] L" , BUFSIZE = integer] L" , PCI = (N, N) or PCI = (N, R) 
or PCI = (N, A) or PCI = (R, N) or PCI = (R, R) or PCI = (R, A) or 
PCI = (A, N) or PCI = (A, R) or PCI = (A, A) ] L\ RESERVE = (integer, 
integer) ] L" , SCT = table ] C , TRANS = table or TRANS = EBCD] 



linedcb 


DCB 


DSORG = TX, MACRF = (G, P), CPRI = S, DDNAME = ddname, 

MH = mhname, INVLIST = (listname f_, B, B or B, A or A, B or A, A],...) 

L", INTVL = integer] C, EXLST = address] L" , BUFIN = integer or 

BUFIN = 1 ] C , BUFOUT = integer or BUFOUT = 2 ] L" , BUFMAX = integer 

or BUFMAX = 2 ] C , BUFSIZE = integer ] Z , PCI = (N, N) or PCI = (N, R) 

or PCI = (N, A) or PCI = (R, N) or PCI = (R, R) or PCI = (R, A) or 

PCI = (A, N) or PCI = (A, R) or PCI = (A, A) ] £ , RESERVE = (integer, 

integer) ] £ , SCT = table ] [ , TRANS = table or TRANS = EBCD] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


DSORG = 


TX 


MACRF = 


(G,P) 


INTVL = 




X 












CPRI = 


R, E, or S 


DDNAME = 


X 














MH = 


X 














EXLST = 








X 








BUFIN = 




X 












BUFOUT = 




X 












BUFMAX = 




X 












BUFSIZE = 




X 












RESERVE = 




X 












SCT = 














X 


TRANS = 


X 












X 


PCI = 


(N, R, or A) , (N, R, or A) 


INVLIST = 


X 












X 
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DEFINE A LOG DATA CONTROL BLOCK 



logdcb 


DCB 


DSORG = PS, MACRF = W, DDNAME = ddname, BLKSIZE = keylen, 
RECFM = F, NCP = integer, SYNAD = address 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


DSORG = 


PS 


MACRF = 


w 


DDNAME = 


X 














BLKSIZE = 




X 












RECFM = 


F 


NCP = 




X 












SYNAD = 








X 









DEFINE A MESSAGE QUEUES DATA CONTROL BLOCK 



diskdcb 


DCB 


DSORG = TQ, MACRF = (G, P), DDNAME = ddname, OPTCD = L 
C , EXLST = listname 3 I , THRESH = integer] 



diskdcb 


DCB 


DSORG = TQ, MACRF = (G, P), DDNAME = ddname, OPTCD = R 
C, EXLST = listname H 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


DSORG = 


TQ 


MACRF = 


(G, P) 


DDNAME = 


X 














OPTCD = 


Lor R 


EXLST = 








X 








THRESH = 




X 
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CLOSE MCP DATA SET 



symbol 


CLOSE 


(dcbname,, . . .)L~, MF = L or MF = (E, listname)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


CLOSE Regular Form 


dcbname 


X 














CLOSE List Form 


dcbname 


X 














MF= L 


CLOSE Execute Form 


dcbname 


X 














MF = (E, 


X 




(I) 











INITIALIZE TCAM MCP 



symbol 


INTRO 


C PROGID = characters ] L , DISK = NO or DISK = YES ] 

[ , CPB = integer ] L" , CIB = integer or CIB = 2 ] L" , PRIMARY = statname 

or PRIMARY = SYSCON] [ , CONTROL = characters or CONTROL = 0] 

L", KEYLEN = integer ][, UNITSZ = integer] [ , LNUN ITS = integer] 

L" , MSUNITS = integer] [ , MSMAX = integer or MSMAX = 70 ] 

[ , MSMIN = integer or MSMIN = 50 ] [ , DLQ = statname or DLQ = ] 

[ , USEREG = integer] L" , INTVAL = integer] L" , CPINTVL = integer 

or CPINTVL = 1800] [ , CPRCDS = integer or CPRCDS = 2 ] 

L", STARTUP = CL"Y] L" 1 ] or STARTUP =W CY] L" 1 ] ] C , 

CKREQS = integer ] [ , RESTART = integer ] [ , PASSWRD = characters 

or PASSWRD = ] [ , CROSSRF = integer ] L" , TRACE = integer ] 

C,TREX IT = address] C , DTRACE = integer ] r_, OLTEST = integer or 

OLTEST = 10 ] [ , COMWRTE = YES or COMWRTE = NO ] 

L" , WTTONE = integer ] L" , TOPMSG = NO or TOPMSG = YES ] 

[ , LINETYP = BISC or LINETYP = STSP or LINETYP = MINI or 

LINETYP = BOTH ] C , FEATURE = (NODIAL or DIAL, N02741 or 2741, 

NOTIMER or TIMER)] 
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INTRO - INITIALIZE TCAM MCP 

Porameter Summary: 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


PROGID = 














X 


DISK = 


YES or NO 


CPB = 




X 












CIB = 




X 












PRIMARY = 


X 












X 


CONTROL = 















X 


KEYLEN = 




X 












UNITSZ = 




X 












LNUNITS = 




X 












MSUNITS = 




X 












MSMAX = 




X 












MSMIN = 




X 












DLQ = 


X 















USEREG = 




X 












INTVAL = 




X 












CPINTVL = 




X 












CPRCDS = 




X 












STARTUP = 


ccYjci]orwcY::n 


CKREQS = 




X 












RESTART = 




X 












PASSWRD = 















X 


CROSSRF = 




X 












TRACE = 




X 












TREXIT = 








X 








DTRACE = 




X 












OLTEST = 




X 












COMWRTE = 


YES or NO 


WTTONE = 




X 












TOPMSG = 


YES or NO 


LINETYP = 


BISC, STSP, MINI, or BOTH 


FEATURE = 


NODIAL or DIAL, N02741 or 2741, NOTIMER or TIMER 
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OPEN MCP DATA SET 



L" symbol ] 


OPEN 


(dcbname I , (OUTPUT or INOUT or INPUT C , IDLE D ) D , . . . ) 
Z , MF = L or MF = (E, listname)] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


OPEN Regular Form 


dcbname 


X 














type 


OUTPUT, INOUT, or INPUT 


status 


IDLE 


OPEN List Form 


dcbname 


X 














type 


OUTPUT, INOUT, or INPUT 


status 


IDLE 


MF = 


L 


OPEN Execute Form 


dcbname 


X 














type 


OUTPUT, INOUT, or INPUT 


status 


IDLE 


MF = (E, 


X 




(1) 











COMPLETE TCAM INITIALIZATION AND ACTIVATION 



C symbol D 


READY 


C GMMSG = address 1 L~ , RSMSG = address 1 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


GMMSG = 








X 








RSMSG = 








X 
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CANCEL A 


MESSAGE 




[symbol] 


CANCELMG 


["mask! [" , CONNECT = AND or CONNECT = OR 1 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


mask 




X 








X 




CONNECT= 


AND or OR 



TAKE INCIDENT CHECKPOINTS OF OPTION FIELDS 


[symbol] 


CHECKPT 




TRANSLATE A MESSAGE 


[symbol] 


CODE 


[rablename or (register) or NONE] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


rablename 


X 




(0-12,15) 








X 



KEEP A COUNT OF MESSAGES 



[symbol] 


COUNTER 


opfld 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


opfld 


X 















CUT OFF RECEPTION OF A MESSAGE 



[symbol] 


CUTOFF 


integer 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


Integer 




X 








X 
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INSERT DATE OR TIME IN A MESSAGE 



[symbol] 


DATETIME 


[DATE = NO or DATE = YES] f , TIME = NO or TIME = YES] 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


DATE = 


YES or NO 


TIME = 


YES or NO 



SEND AN ERROR MESSAGE 



[symbol] 


ERRORMSG 


["maskl T , CONNECT = AND or CONNECT = ORl , DATA = 
message [ , DEST = destname or DEST = opfld or DEST= ORIGIN 
or DEST = DESTIN ] Q , EXIT = address] 



[symbol] 


ERRORMSG 


Tmask 1 T . CONNECT = AND or CONNECT = OR 1 . DATA = 
address [ , DEST = destname or DEST = opfld or DEST = ORIGIN or 
DEST = DESTIN ] [, EXIT = address] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


mask 




X 








X 




DATA = 








X 






X 


DEST = 


X 










X 


X 


EXIT = 








X 








CONNECT= 


AND 


or OR 
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FORWARD A MESSAGE 




[symbol] 


FORWARD 


[DEST = destname or DEST = opfld orDEST= (number) or DEST = PUT or 
DEST= **! [ , EOA= characters ~\ [ . EXIT = addressl 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


DEST = 


X 


(X) 










X 


EOA = 












X 


X 


EXIT = 








X 









SUSPEND MESSAGE TRANSMISSION 






[symbol J 


HOLD 


[mask] [ , RELEASE ] [ , INTVL = 
or CONNECT = OR] 


integer] [ 


, CONNECT = AND 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


mask 




X 








X 




RELEASE 


Written as shown 


INTVL = 




X 








X 




CONNECT = 


AND or OR 



DEFINE START OF INBUFFER SUBGROUP 



[symbol ] 


INBUF 


[PATH= (opfld, switch)] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


opfld 


X 














switch 




X 








X 





DEFINE END OF INCOMING GROUP 


[symbol ] 


INEND 




DEFINE START OF INHEADER SUBGROUP 


[symbol ] 


INHDR 


[PATH= (opfld, switch)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 




CHARS 


opfld 


X 














switch 




X 








X 
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EXPEDITE 


MESSAGE DISTRIBUTION 




[symbol] 


INITIATE 


[conchars [, BLANK = 


character or BLANK = NO or BLANK = YES "|] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


conchars 












X 


X 


BLANK = 












X 


X 



DEFINE START OF INMESSAGE SUBGROUP 



[symbol J 


INMSG 


[PATH= (opfld, switch)] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


opfld 


X 














switch 




X 








X 





LOCK STATION TO APPLICATION PROGRAM 



[symbol ] 


LOCK 


TEXTEND or MESSAGE 1 1" . conchars l\ BLANK = character or BLANK = 
NO or BLANK = YES 11 



. PARAMETER 
WRITTEN AS 


DEC 
SYM DIG REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


type 


MESSAGE or EXTEND 


conchars 












X 


X 


BLANK = 












X 


X 



LOCATE OPTION FIELDS 




[symbol ] 


LOCOPT 


opfld [, (register 


) or (15)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


opfld 


X 














register 






(2-12,15) 











LOG MESSAGES OR SEGMENTS 



[symbol ] 


LOG 


dcbname or typename 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


dcbname 


X 














typename 


X 
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EDIT A MESSAGE 



[■symbol] 


MSGEDIT 


( (1 or R [A] [T ] , characters or (hexform,n) or DELIMIT or 
CONTRACT] f_ , characters or offset or (integer, opfld) or SCAN] 
[ , characters or offset or SCAN or (count) or (Q)] ),...)[/ BLANK = 
character or BLANK = NO or BLANK = YES ] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


function 


1 or R [A] [T] 


data 


DELIMIT or CONTRACT 


characters 












X 


X 


(hexform 












X 




,n) 




X 














PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


AT 


SCAN 


characters 












X 


X 


offset 




X 












(integer 




X 












, opfld) 


X 














TO 


SCAN or (0) 


characters 












X 


X 


offset 




X 












(count) 




X 













FORMAT A 


MESSAGE 






[symbol] 


MSGFORM 


[BLOCK = integer ] [, SUBBLCK = 
SENDTRP= NOT 


integer J [, SENDTRP = YES or 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


BLOCK = 




X 








X 




SUBBLCK = 




X 








X 




SENDTRP = 


YES or NO 
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GENERATE A MESSAGE 



[symbol J 


MSGGEN 


Tmaskl , message T, CONNECT = AND or CONNECT = OR ~\ [ , 
CODE = tablename or CODE = NOJ 


jr 


[symbol ] 


MSGGEN 


["mask ] , fldname f, CONNECT = AND or CONNECT = OR 1 I, 
CODE = tablename or CODE = NOj 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


mask 


X 








X 




message 












X 


X 


CONNECT = 


AND or 


OR 












CODE = 








X 






X 


fldname 








X 









LIMIT MESSAGES 



fjsymbol J 


MSGLIMIT 


integer or opfld 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


integer 




X 








X 




opfld 


X 















DEFINE MESSAGE TYPE 






[symbol J 


MSGTYPE 




[conchars [, BLANK = 


character or BLANK = NO or BLANK = YES "|1 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


conchars 












X 


X 


BLANK = 












X 


X 



IDENTIFY MESSAGE ORIGIN 



[symbol ~\ 


ORIGIN 


[integer or X'FF 1 J 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


length 




X 








X 
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DEFINE START OF OUTBUFFER SUBGROUP 



[symbol] 


OUTBUF 


[PATH = (opfld, switch)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


opfld 


X 














switch 




X 








X 





DEFINE END OF OUTGOING GROUP 


[symbol] 


OUTEND 




DEFINE START OF OUTHEADER SUBGROUP 


[symbol] 


OUTHDR 


[PATH = (opfld, switch)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


opfld 


X 














switch 




X 








X 





DEFINE START OF OUTMESSAGE SUBGROUP 



[symbol] 


OUTMSG 


[PATH = (opfld, switch)] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


opfld 


X 














switch 




X 








X 





SET A PATH SWITCH 



[symbol] 


PATH 


switch, opfld [, conchars [, BLANK = character or 
BLANK = NO or BLANK = YESl] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


switch 




X 








X 




opfld 


X 














conchars 












X 


X 


BLANK = 












X 


X 
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DEFINE MESSAGE PRIORITY 



["symbol] 


PRIORITY 


[integer]) T/ conchars [_, BLANK = character or BLANK = NO or 
BLANK = YES] 1 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


integer 




X 












conchars 












X 


X 


BLANK = 












X 


X 



REDIRECT A MESSAGE 



[symbol J 


REDIRECT 


[mask] [. CONNECT = AND or CONNECT = OR 1 f" r DEST = 
destname or DEST = opfld or DEST = ORIGIN] 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


mask 




X 








X 




CONNECT = 


AND or OR 


DEST = 


X 












X 



SET DISPLAY SCREEN 



[symbol] 


SCREEN 


[WRE or WLA or WDC] [ , conchars [, BLANK = character or 
BLANK = NO or BLANK = YESj] 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


type 


WRE, WLA, or WDC 


conchars 












X 


X 


BLANK = 












X 


X 



INSERT OR VERIFY MESSAGE SEQUENCE 



[symbol] 


SEQUENCE 





SET END 


OF FILE 




[symbol] 


SETEOF 


[conchars C BLANK = character or BLANK = NO or BLANK = YES]] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


conchars 












X 


X 


BLANK = 












X 


F/U 
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SET SCAN POINTER 



[symbol] 


SETSCAN 


skipchars [, BLANK = character or BLANK = NO or BLANK = YES 1 
f . POINT = FORWARD 1 [ . MOVE = RETURN or MOVE = KEEP 1 
F , RESULT = (register) or RESULT = (15)1 



[symbol] 


SETSCAN 


integer [, BLANK = character or BLANK = NO or BLANK = YESl 
1", POINT = BACK or POINT = FORWARD 1 |", MOVE = KEEPl or 
MOVE = RETURN [ , RESULT = (15) or RESULT = (register)] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


skipchars 












X 


X 


integer 




X 












BLANK = 












X 


X 


POINT = 


BACK or FORWARD 


MOVE = 


RETURN or KEEP 


RESULT = 






(2-12,15) 
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DEFINE START OF MH 



symbol 


STARTMH 


LC = IN [, STOP = YES or STOP = (opfld, switch)] [ , CONV = YES or 
CONV = (opfld, switch) or CONV = NO] |" , LOGICAL = opfld or 
LOGICAL = (opfld, switch, opfld)] [, BREG = integer or BREG = l] 
[, CONT = YES or CONT = (opfld, switch)] 



symbol 


STARTMH 


LC = OUT [ , STOP = YES or STOP = (opfld, switch)] [_ . CONV = YES or 
CONV = (opfld, switch) or CONV = NO ] [, LOGICAL = opfld or 
LOGICAL = (opfld, switch, opfld) ] [ , BREG = integer or BREG = 1] 
[, CONT = YES or CONT = (opfld, switch)] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


LC = 


IN or OUT 


STOP = 


YES or 


(opfld 


X 














, switch) 




X 








X 




CONT = 


YES or 


(opfld 


X 














, switch) 




X 








X 




CONV = 


YES or NO or 


(opfld 


X 














, switch) 




X 








X 




LOGICAL = 
opfld 


X 














LOGICAL = 
switch 




X 








X 




BREG = 




X 













SET USER ERROR BIT 



[symbol] 


TERRSET 





UNLOCK A 


LOCKED STATION 


[symbol] 


UNLOCK 


[conchars [ # BLANK = character or BLANK = NO or BLANK = YES]] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


conchars 












X 


X 


BLANK = 












X 


X 



Figure 61. TCAM Message Handler Macros (Part 10 of 10) 
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WAIT FOR AND TEST COMPLETION OF A READ OR WRITE 



C symbol 1 


CHECK 


decbname 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


decbname 


X 















REQUEST A CHECKPOINT 



Z symbol ] 


CKREQ 





CLOSE APPLICATION PROGRAM DATA SET 



[ symbol ] 


CLOSE 


(dcbname, , . . . ) [ , MF = L or MF = (E, listname) J 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


CLOSE Regular Form 


dcbname 


X 














CLOSE List Form 


dcbname 


X 














MF = 


L 


CLOSE Execute Form 


dcbname 


X 














MF= (E, 


X 




0) 











Figure 62. TCAM Application Program Macros (Part 1 of 7) 
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DEFINE INPUT DATA CONTROL BLOCK 



dcbname 


DCB 


DSORG = PS, MACRF = GM C T ] , DDNAME = ddname, 
BLKSIZE = integer [ , BUFL = integer ] [ , LRECL = integer ] 
L" . RECFM = F or RECFM = V L" B] or RECFM = U] 
C, OPTCD = [WKU3 CC ]] [, EODAD = address] 
L" , SYNAD = address ] L" , EXLST = address] 



dcbname 


DCB 


DSORG = PS, MACRF = GL [ T J , DDNAME = ddname, 
BLKSIZE = integer C , BUFL = integer 1 L~ , LRECL = integer!] 
C . RECFM = F or RECFM = V CB] or RECFM = U] 
L", OFTCD = CW]QUDCCD]C, EODAD = address] 
C , SYNAD = address 3 I, EXLST = address] 



dcbname 


DCB 


DSORG = PS, MACRF = R C P ] , DDNAME = ddname, 
BLKSIZE = integer C , BUFL = integer ] I , LRECL = integer] 
L" , RECFM = F or RECFM = V [B] or RECFM = U ] 
L", OPTCD=CW]CU][:C] ][, EODAD = address] 
L" , SYNAD = address ] C, EXLST = address] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


DSORG = 


PS 


MACRF = 


CGM, GMT, GL, GLT, R, RP] 








DDNAME = 


X 














BLKSIZE = 




X 












BUFL = 




X 












LRECL = 




X 












RECFM = 


F, V, VB, or U 


OPTCD = 


W, WU, WC, U, UC, C, orWUC 


EODAD = 








X 








SYNAD = 








X 








EXLST = 








X 









Figure 62. TCAM Application Program Macros (Part 2 of 7) 
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DEFINE OUTPUT DATA CONTROL BLOCK 



dcbname 


DCB 


DSORG = PS, MACRF = PM, DDNAME = ddname 
[ ,BLKS|ZE= integer] [ , LRECL = integer] 
L" , OPTCD = CW]CU]CC:]C, SYNAD = address] 
[ , RECFM = F or RECFM = V [B] or RECFM = U] 
[ , EXLST = address ] [ , BUFL= integer] 



dcbname 


DCB 


DSORG = PS, MACRF = PL, DDNAME = ddname 
C , BLKSIZE = integer ] L" , LRECL = integer] 
C, OPTCD = [W][U]CC]]:, SYNAD = address] 
C. RECFM = F or RECFM = VCB] or RECFM = U] 
[, EXLST = address ] [, BUFL = integer] 



dcbname 


DCB 


DSORG = PS, MACRF = W, DDNAME = ddname 
C , BLKSIZE = integer ] [ , LRECL = integer] 
L", OPTCD = CW]CU]CC]]C, SYNAD = address] 
■' L" , RECFM = F or RECFM = V CB] or RECFM = U] 
C , EXLST = address ] [ , BUFL = integer] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


DSORG = 


PS 


MACRF = 


PM, PL, or W 


DDNAME = 


X 














BLKSIZE = 




X 












LRECL = 




X 












OPTCD = 


W, WU, WC, WUC, U, UC, or C 


SYNAD = 








X 








RECFM = 


F, V, VB, or U 


EXLST = 








X 








BUFL = 




X 













GET A WORK UNIT 



L~ symbol ] 


GET 


dcbname f, areaname] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


dcbname 


X 














areaname 








X 









Figure 62. TCAM Application Program Macros (Part 3 of 7) 



Appendix B. TCAM Macro Operand Summary 173 



CHANGE INVITATION LIST 



L~ symbol 2 


ICHNG 


grpname, 


rln, areaname [, PASSWRD = characters} 


or 


C symbol 3 


ICHNG 


grpname, 


rln, ACT [, PASSWRD = characters J 


or 


[ symbol D 


ICHNG 


grpname, 


rln, DEACT [ , PASSWRD = characters] 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


grpname 


X 




(0-14) 










rln 


X 




(0-14) 










type 






(0-14) 


X 






X 


PASSWRD = 














X 



COPY INVITATION LIST 



[ symbol ] 


ICOPY 


grpname, rln, areaname 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


grpname 


X 




(1-15) 










rln 




X 












areaname 






(0, 1) 


X 









CLOSE THE TCAM SYSTEM 



C symbol D 


MCPCLOSE 


L" QU ICK or FLUSH 1 [ , PASSWRD = characters ] 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


type 


QUICK or FLUSH 


PASSWRD = 






* 








X 



RELEASE A HELD STATION 



L~ symbol ] 


MRELEASE 


statname [ , PASSWRD = characters} 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


statname 


X 


PASSWRD = 














X 



Figure 62. TCAM Application Program Macros (Part 4 of 7) 
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OPEN APPLICATION PROGRAM DATA SET 



E symbol 1 


OPEN 


(dcbname,, . . .) C, MF = L or MF = (E, listname)3 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


OPEN Regular Form 


dcbname 


X 














OPEN List Form 


dcbname 


X 














MF = 


L 


OPEN Execute Form 


dcbname 


X 














MF=(E, 


X 




(1) 











DEFINE PROCESS CONTROL BLOCK 



symbol 


PCB 


MH = mhname, BUFSIZE = integer L~ , BUFIN = integer or BUFIN = 2 ] 
L , BUFOUT = integer or BUFOUT = 2 ] [ , RESERVE = (integer, integer) ] 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


MH = 


X 














BUFSIZE = 




X 












BUFIN = 




X 












BUFOUT = 




X 












RESERVE = 




X 













POINT TO A RECORD TO BE RETRIEVED 



E symbol 1 


POINT 


dcbname, address 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


dcbname 


X 














address 








X 









PUT A WORK UNIT 



C symbol ] 


PUT 


dcbname [ , areaname 3 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


dcbname 


X 














areaname 








X 









Figure 62. TCAM Application Program Macros (Part 5 of 7) 
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COPY QUEUE CONTROL BLOCK 



L symbol J 


QCOPY 


statname, areaname 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


statname 


X 




(0, 2-15) 










areaname 






(1-15) 


X 









READ A WORK UNIT 



C symbol] 


READ 


decbname, SF, dcbname, areaname L , length or 'S'J 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


decname 


X 














SF 


written as shown 


dcbname 


X 














areaname 








X 








length 




X 










'S' 



CHANGE TERMINAL-TABLE ENTRY 



[symbol ] 


TCHNG 


statname, areaname Z i PASSWRD = characters D 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


statname 


X 














areaname 








X 








PASSWRD = 














X 



COPY TERMINAL-TABLE ENTRY 



L symbol J 


TCOPY 


statname, areaname 



PARAMETER 
WRITTEN AS 


SYM 


DEC 
DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


statname 


X 




0) 










areaname 






(0) 


X 









Figure 62. TCAM Application Program Macros (Part 6 of 7) 
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WRITE A WORK UNIT 



L symbol J 


WRITE 


decbname, SF, dcbname, areaname [ , length or 'S' 3 



PARAMETER 
WRITTEN AS 


DEC 
SYM DIG 


REG 


RX- 
TYPE 


A-TYPE 
ADCON 


HEX 
DIG 


CHARS 


decbname 


X 














SF 


written as shown 


dcbname 


X 














areaname 








X 








length 




X 










'S' 



Figure 62. TCAM Application Program Macros (Part 7 of 7) 



START QTAM APPLICATION PROGRAM TO RUN WITH TCAM 



rjsymbol ] 


QSTART 





EDIT IBM 50 MDI CONTROL CHARACTERS 



fsymbol 1 


TPEDIT 


MINLN = N ["• EDIT = EDITR or EDIT = EDITD ] [ , RECFM = U or 
RECFM = VJ [, ERROPT = name or ERROPT = IGNORE 1 [" , VERCHK = 
VOKCHK or VERCHK = NOCHK J [ , REPLACE = X'nn 1 or REPLACE = 
X'19 1 1 f . BUFFER = YES or BUFFER = NO! 



PARAMETER 
WRITTEN AS 


DEC RX- A-TYPE HEX 
SYM DIG REG TYPE ADCON DIG CHARS 


MINLNN 




X 












EDIT= 


EDITR or EDITD 


RECFM= 


Uor V 


ERROPT= 










X 




X 


VERCHK= 


VOKCHK or NOCHK 


REPLACE= 












X 




BUFFER= 


YES or NO 



Figure 63. Other TCAM Macros 
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Appendix C. TCAM Formatted ABEND Dump 



A formatted TCAM dump is automatically produced as a part of the OS 
ABEND/SNAP storage dump when TCAM is resident in the system. 
ABEND/SNAP storage dumps occur immediately after an abnormal termination, 
provided that the control program or problem program has issued an ABEND or 
SNAP macro instruction, or when the operator issues a CANCEL command that 
requests a dump, and the proper dump data sets have been defined. 

The TCAM part of an MFT dump starts after the TRACE TABLE entries, and in 
an MVT dump, the TCAM part starts after the SAVE AREA TRACE entries. 
For a complete discussion of the OS portion of the dump, see the Guide to 
Reading Dumps. 

The following discussion of the TCAM part of either the OS MFT or MVT dump 
is interspersed with sample sections from an ABEND dump. Capital letters 
represent the headings found in all dumps, and lowercase letters represent inform- 
ation that varies. The lowercase letter used indicates the mode of the information, 
and the number of letters indicate the length of the information. 

• h represents 1/2 byte of hexadecimal information 

• d represents one byte of decimal information 

• c represents a one-byte character 



TCAM 


ADDRESS VECTOR TABLE 


hhhhhh 










SAVE 


AREA 1 














0000 
0020 
0040 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


SAVE 


AREA 2 














0048 
0060 
0080 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


SAVE 


AREA 3 














0090 
O0A0 
00C0 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


SAVE 


AREA 4 














0008 
00E0 
0100 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


DISABLED SAVE AREA 












0120 
0140 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 



TCAM ADDRESS VECTOR TABLE hhhhhh is the starting address of the 
TCAM address vector table (AVT), which is generated by the INTRO macro 
instruction. The formatted dump of the AVT beginning with the first save area, 
labeled save area 1, follows the TCAM ADDRESS VECTOR TABLE hhhhhh 
heading. 

SAVE AREA 1 is the contents of the first save area defined in the AVT. The 
registers are saved in and restored from this area according to standard linkage 
conventions. Along the left-hand side of the dump are the relative offsets of this 
save area from the beginning of the AVT. 
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SAVE AREA 2 is the contents of the second save area defined in the AVT. The 
registers are saved in and restored from this area according to standard linkage 
conventions. Along the left-hand side of the dump are the relative offsets of this 
save area from the beginning of the AVT. 

SAVE AREA 3 is the contents of the third save area defined in the AVT. The 
registers are saved in and restored from this area according to standard linkage 
conventions. Along the left-hand side of the dump are the relative offsets of this 
save area from the beginning of the AVT. 

SAVE AREA 4 is the contents of the fourth save area defined in the AVT. The 
registers are saved in and restored from this area according to standard linkage 
conventions. Along the left-hand side of the dump are the relative offsets of this 
save area from the beginning of the AVT. 

DISABLED SAVE AREA is the contents of the fifth save area defined in the 
AVT. When a disabled TCAM routine gains control from the I/O supervisor, it 
saves and restores consecutively the I/O supervisor's registers through 9 in this 
save area. 



TABLE POINTERS 




0148 hhhhhhhh hhhhhhhh 
0160 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 



TABLE POINTERS are the addresses of the first device characteristics table; 
three work areas used by the internal TCAM logic; the operator control message 
identification string; the scrambled password character string; the TCAM MCP 
TCB; and the TCAM I/O trace table. The following chart shows the different 
fields, their offsets relative to the beginning of the AVT (which are also given on 
the left-hand side of the dump), their length, and their contents. 
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+0148 



Address of the first DCT entry 



+014C 



Disabled parameter list 



+0150 



+0154 



Disabled doubleword scratch area 



+0158 



+01 5C 



Enabled doubleword scratch area 



+0160 



+0164 



The operator control message identification character string 



+0168 



+01 6C 



The scrambled password character string 



+0170 



Address of the TCB of the TCAM MCP 



+0174 



Address of the TCAM line I/O trace table 



DISPATCHER READY QUEUES 

lii SSKKX iSKfttt ISSiSHS ^ hhhh hhhhhhhh hhhhhhhh "*"*»* wKSffih 

airn SS^S S vuuuu h . h hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

uxco hhhhhhhh hhhhhhhh hhhhhhhh 



DISPATCHER READY QUEUES gives the contents of the TCAM dispatcher 
ready queues (one enabled, one disabled) and various other fields in this section 
of the AVT. The different fields, their offsets relative to the beginning of the 
AVT (which are also given on the left-hand side of the dump), their length, and 
their contents are illustrated below. 
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+0178 



Enabled ready queue (points to first element to be dispatched) 



+017C 



First word of the disabled FIFO ready queue 



+0180 



Second word of the disabled FIFO ready queue 



+0184 



Checkpoint work area 



+0188 



Operator control work area 



+01 8C 



+0190 



+0194 



Executable instructions to save the user's registers, if requested 



+0198 



Parameter list 



+019C 



Protection key 



+01 9D 



Address of the AVT 



+01 AO 



Address of additional optional parameters 



+01 A4 



Address of the TCAM dispatcher subtask trace table 



+01 A8 



Address of the termname table 



+01 AC 



User exit address in the READY macro expansion 



+01 BO 



Address of the Line End Appendage BSC message scan subroutine (SCAN) 



+01 B4 



Address of the Line I/O Interrupt Trace routine (IGG019Q0) 



+01 B8 



+01BC 



Tpost parameter list used by operator control 



+01 CO 



Address of start parameter list 



+01 C4 



Number of 
CIBs 



+01 C5 



Number of 
checkpoint requests 



+01 C6 



Number of line units 



+01 C8 



Address of Hold/Release Terminal routine (IEDQAS) 
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TCB POINTERS 
01CC 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



TCB POINTERS give the addresses of the TCBs for checkpoint, operator control, 
on-line test, and the FE Common Write (COMWRITE) task. These tasks are 
attached tasks of the TCAM MCP. The following chart shows the fields contain- 
ing the addresses and the offsets of the fields relative to the beginning of the 
AVT. 



+01 cc 



Address of the Checkpoint TCB 



+01 DO 



Address of the Operator Control TCB 



+01 D4 



Address of the On-Line Test TCB 



+01 D8 



Address of the FE Common Write TCB 



ECBS 

01DC 
01E0 
0200 
0220 
0240 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh 



hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



ECBs contain the addresses of some of the internal routines and subtasks of the 
TCAM MCP, the addresses of certain TCAM tables, the checkpoint ECB, the 
on-line test ECB, the operator control ECB, the ECB used by the TCAM dis- 
patcher to cause TCAM to enter a wait state when the ready queues are empty, 
and the address of the FE Common Write (COMWRITE) ECB. The following 
example gives a list of the different fields, their contents, and their relative offsets 
from the beginning of the AVT (which are also given on the left-hand side of the 
dump). 
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+01 DC 


Address of the FE Common Write ECB 


+01 E0 


Checkpoint ECB 


+01E4 


On-Line Test ECB 


+01 E8 


Operator Control ECB 


+01EC 


ECB used by the dispatcher to cause TCAM to be in wait state 


+01 FO 


Address of the first process entry control block 


+01 F4 


Address of the option table 


+01 F8 


Address of the I/O Generator in the Activate subtask 


+01 FC 


Address of the user trace exit 


+0200 


Address of the cross-reference table 


+0204 


Address of the communications parameter list 


+0208 


Address of the User Interface routine (IEDQUI) 


+020C 


Address of the Return Interface routine (IEDQLM) 


+0210 


Address of the routine to remove an element from 
the Time Delay QCB (IEDQHG02) 


+0214 


Address of the Address Finder routine (IEDQAL) 


+0218 


Address of the Buffer Association routine (IEDQGD) 


+021 C 


Address of the Transparency CCW Builder routine (IEDQGT) 


+0220 


Address of the Buffer Step routine (IEDQAX) 


+0224 


Address of the TCAM Dispatcher (IGG019RB or IGG019RO) 


+0228 


Address of the Leased Receive Scheduler (IGG019R3) 
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+022C 



Address of the Send Scheduler (IGG019R4) 



+0230 



Address of the Get Scheduler (IEDQEW) 



+0234 



Address of the Put Scheduler (IEDQEC) 



+0238 



Address of the Get FIFO Scheduler (IEDQE2) 



+023C 



Address of the Log Scheduler (IEDQB2) 



+0240 



Address of the Dial Receive Scheduler (IGG019R1) 



+0244 



Address of the Buffered Terminal Scheduler (IGG019RD) 



+0248 



Address of the Retrieve Scheduler (IEDQE7) 



SPECIAL 

021C 
0260 
0280 
02A0 
02C0 


ELEMENTS 

hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 



SPECIAL ELEMENTS contain the interval checkpoint element, a special element 
to request removal of the interval checkpoint element for the time delay queue, 
the incident checkpoint element, and several address and constant areas used by 
the internal TCAM logic. The following chart gives a list of the different fields, 
their contents, their size, and their relative offsets from the beginning of the AVT. 
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+024C 



+0250 



+0254 



+0258 



+025C 



+0260 



+0264 



+0268 



+026C 



+0270 



Reserved 



Reserved 



Reserved 



Reserved 



Reserved 



Reserved 



Reserved 



Reserved 



Reserved 



Dummy Line ECB 



+0274 



Address of the translation list for IEDQA3 



+0278 



Address of the World Trade tone characters 



+027C 



Address of the Operator Awareness Message Router routine (IEDQIMX) 



+0280 



Address of the I/O Trace Table Handler routine (IGG019Q0) 



+0284 



Address of the System Delay QCB 



+0288 



Address of the Stop Line QCB 



E 



+028C 



Special element to cause removal of the checkpoint 





element from the time delay queu 


e 






+029C 
"^2A0 Element to request interval checkpoint 





+02A4 

Size of SCB 


+02A5 

Address of Checkpoint QCB 


+02A8 Checkpoint request 
element flags 


+02 A9 Number of 

checkpoint records 


+02AA 

Checkpoint time interval 


+02AC 

Time of day of interrupt 


«*** Offset to 

Checkpoint QCB 


+02 A F 


Open error 
locator 


+02B0 

Open module ID having error 


+02B2 

Type of Open error 


+02B3 


Checkpoint time 
delay status 


+02B4 Open translate 
byte 


+02B5 

Address of Time Delay subroutine (IEDQHG01) 
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■H)2B8 



Offset to Binary 
Search routine 



+02B9 



Link field on time queue 



+02BC 



Dummy last element 



4O2C0 



Address of dummy last element 



+02C4 



+02C8 



Incident checkpoint element 



+02CC 



Halfword constant X'0000' 



+02CE 



Halfword constant X'FFFF' 



■H)2D0 



Address of current buffer being processed (by message handler) 



-K32D4 



Address of the 2260 Local Line End Appendage (IGG019R5) 



+02D8 



System error 
flag byte 



+02D9 



Address of list of V-type address constants 



QCB POINTERS 
















02DC 
















hhhhhhhh 


02E0 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0300 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0320 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0340 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0360 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0380 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 











QCB POINTERS contain the available buffer QCB, the buffer return QCB, the 
checkpoint QCB, the operator control QCB, the on-line test QCB, the activate 
QCB, the closedown QCB, the QCB to remove the checkpoint element from the 
time-delay queue, the disk I/O QCB, the CPB cleanup QCB, the address of the 
start-up message QCB, the address of the time-sharing input QCB, the address of 
the application program OPEN/CLOSE routine, the address of the first byte of 
main storage obtained by GETMAIN for the buffer-unit pool, a word containing 
the number of buffer units being used by the main-storage message queues data 
set, and a fullword constant of zeros. The following chart gives a list of the 
different fields, their contents, their size, and their relative offsets from the 
beginning of the AVT. 
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+02DC 



Queue of available insert blocks 



+02E0 



Address of the Start-up Message QCB 



+02E4 



Address of the Time Sharing Input QCB 



+02E8 



Address of the application program OPEN/CLOSE routine (IEDQEU) 



+02EC 





Time Delay QCB 






+02FC 


Reference time 


+02FE 

Dummy INEND/OUTEND AVT 


+0300 
+0304 


SVC 102 parameter list, used to cause SVC 102 to tpost the time 
Delay QCB to itself when a timer interrupt occurs 


— 


+0308 


Time delay queue 




J-030C 


Available Buffer QCB 







~3 



i 



+0318 



Buffer Return QCB 



+0324 



3 



Checkpoint QCB 



2 



+0330 



Operator Control QCB 



5 



+033C 



On-Line Test QCB 



£ 



+0348 



3 
I 



Activate QCB 



+0354 



Closedown QCB 



+0360 



QCB to remove checkpoint element from time delay queue 



+036C 



Disk I/O QCB 



3 



+0378 



CPB Cleanup QCB 



+0384 



Address of area obtained by GETMAIN for buffer-unit pool 



+0388 



Number of buffer units being used by main-storage message queues 



+038C 



Fullword constant of zero 
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INTERFACE 
















0390 








hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


03A0 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


03C0 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


03E0 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0400 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 



INTERFACE contains a GETMAIN parameter list used to obtain the buffer-unit 
pool, the key length specified for the message queues, the number of lines opened, 
the number of lines in the system delay, the offset into the termname table of the 
primary operator control terminal, the number of buffer units in the buffer pool, 
the number of lines serviced by the Start-up Message subtask, the number of 
seconds of the system delay, the offset into the termname table of the dead-letter 
queue terminal, three flags and several constants used by the internal TCAM 
logic, the number of restart checkpoint records, the number of buffers or CPBs on 
the EXCP or retry queue, and the address of the FE Patch module used for 
additional serviceability routines. Also, there are an FE work area, two parameter 
list pointers, two ECBs, and four flag bytes all used by the FE Common Write 
(COMWRITE) subtask. The following chart gives a list of the different fields, 
their contents, their size, and their relative offsets from the beginning of the AVT. 
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+0390 






Address of the FE Patch module (IEDQFE) 






+0394 






First parameter list pointer 






+0398 






First ECB 






+039 C 


FE flag byte 1 


+039D 


FE flag byte 2 


+039E 

FE flag byte 3 


+039 F 


FE flag byte 4 




+03A0 






Second parameter list pointer 






+03A4 






Second ECB 






+03A8 

+03AC 
+03B0 

+03B4 
+03B8 
+03BC 

+03C0 
+03C4 
+03C8 
+03CC 
+03D0 
+03D4 
+03D8 
+03DC 
+03E0 

+03E4 
+03E8 






FE work area 



























































































































— — 
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+03EC 


+03F0 


+03F4 

— GETMAIN parameter list — 
+03F8 


+03FC 


+03FE 

Halfword constant of 2 


-K)400 

Halfword constant of 3 


+0402 

Halfword constant of 4 


+0404 

Halfword constant of 7 


+0406 

Halfword constant of 16 


+0408 

Key length on message queues 


+040A 

Number of lines opened 


+040C Number of lines 
in system delay 


+040E Offset to primary operator 
control terminal 


Number of buffer units 
in buffer-unit pool 


■+04 12 Number of lines serviced by 
Start-up Message subtask 


+0414 Number of seconds 
of system delay 


+041 6 Offset to dead-letter 
terminal 


+0418 

BR instruction 


+041 A 

Flag byte 1 


+041 B 

Flag byte 2 


+041 C 

Flag byte 3 


Number of restart 
checkpoint records 


11041 E Number of buffer or CPBs 
on EXCP or retry queue 



Note: This is the end of the AVT when ENVIRON=TSO has been specified 
on the INTRO macro instruction. 



CORE QUEUE 

0420 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



CORE QUEUE contains the address of the Destination Assignment routine, the 
values specified by the MSMIN=, MSMAX=, and MSUNITS= operands of the 
INTRO macro instruction, and a queue of buffers and ERBs waiting to be proc- 
essed. The following chart gives a list of the different fields, their contents, their 
size, and their relative offsets from the beginning of the AVT. 
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+0420 

Address of the Destination Assignment routine (IEDQHM02) 



+0424 

MSMIN=integer 



+0428 

MSMAX=integer 



+042C 

Number of units usable in main-storage queues (MSUNITS=integer) 



+0430 

Queue of buffers and ERBs waiting 

— to be processed 

+0434 



DISK 


















0438 














hhhhhhhh 


hhhhhhhh 


0440 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0460 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


0480 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


04A0 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


04C0 


hhhhhhhh 


hhhhhhhh 


hhhh 













DISK contains the queues and control information for the disk message queues 
(reusable and nonreusable) for the TCAM MCP. The following chart gives a list 
of the different fields, their contents, their size, and their relative offsets from the 
beginning of the AVT. 
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+0438 



Address of the Disk EXCP Driver routine (IGG019RC) 



+043C 



Address of the Reusability subtask (IGG019RP - REUS) 



+0440 



Address of the Copy subtask QCB (IGG019RP - COPY) 



+0444 



+0448 



Disabled queue of CPBs to be processed by CPB Cleanup 



+044C 



+0450 



Enabled queue of CPBs to be processed by CPB Cleanup 



+0454 



+0458 



Queue of CPBs waiting for buffers 



+045C 



+0460 



Reserved 



+0464 



+0468 



Queue of CPBs requesting I/O to be done by the Disk EXCP Driver 



+046C 



Queue of inactive CPBs, called the CPB free pool 



+0470 



Address of the CPB free pool 



+0474 



Address of list of lOBs for reusable disk queues 



+0478 



Address of list of lOBs for non reusable queues 



+047C 



Reusable disk queue when Reusability subtask activated 



+0480 



Address of DEB (reusable disk) 



+0484 



Number of extents (reusable disk) 



+0488 



Number of records per track (reusable disk) 



+048C 



Number of tracks per cylinder (reusable disk) 
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+0490 


Number of records in entire data set (reusable disk) 


+0494 


Product of number of extents times»number of records 
per track (reusable disk) 


+0498 


Address pf DEB (nonreusable disk) 


+049 C 


Number of extents (nonreusable disk) 


+04A0 


Number of tracks per cylinder (nonreusable disk) 


+04A4 


Number of records per track (nonreusable disk) 


+04A8 


Number of records in entire data set (nonreusable disk) 


+04AC 


Product of number of extents times number of records 
per track (nonreusable disk) 


+04B0 


Absolute record number that is the threshold to cause 
closedown due to filling of the nonreusable disk queue 


+04B4 


Nonreusable disk queue 


+04B8 


Reusable disk queue 


-+04BC 





Nonreusable Threshold Closedown Element 



IT 



+04C8 



CPB = integer 



Note: This is the end of the AVT. 



TNT 


hhhhhh 


CODE hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 






hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhh 






SRCHX hhhh ENLEN 


hh MIDEN 


hhhhhh LEN 


hhhh 








DCODE hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 






hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 





TNT hhhhhh is the address of the TCAM termname table, which contains the 
names and addresses of all of the terminal-table entries. (Each of the terminal- 
table entries is displayed following this section of the dump.) 

CODE is the executable termname table code that converts the invitation list 
relative position field into the absolute address of the terminal-table entry. This 
code is used only by enabled routines. 

SRCHX hhhh is the search extent factor. 

ENLEN hh is the number of bytes in each entry. 

MIDEN hhhhhh is the absolute address of the middle entry. 

LEN hhhh is the total number of entries. 
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DCODE is the executable termname table code that converts the invitation list 
relative position field into the absolute address of the terminal-table entry. This 
code is used only by disabled routines. 

Following the TNT section of the dump are each of the terminal-table entries 
along with their option-table entries (if any exist) and contents. Some additional 
fields in each of the terminal-table entries may or may not be present according to 
the optional parameters specified on the TERMINAL macro instruction. These 
are discussed where applicable. Four different types of entries are in the terminal 
table. They are single entries, list entries (cascade and distribution), process 
entries, and line entries. The following four sections give an example of each type 
of entry. Each of the four types of entries has a STATE field, which is the status 
byte of the terminal-table entry. The following example is a list of the bit mean- 
ings of this one-byte status field. 

Bit(s) Meaning 

0-2 000 = single entry 

001 = process entry 

010 = list entry (cascade or distribution) 
100 = line entry 

3 always for a GET-type list or a GET-type process entry 
always 1 for a single entry, line entry, 

or a PUT-type process entry 

4 = a PUT-type process entry (if process entry) 
1 = a GET-type process entry (if process entry) 

(always 1 for other type entries) 

5 = terminal is not in hold mode 

1 = terminal is in hold mode (If this is a process entry, 
it indicates CKPTSYN=YES was specified on the 
TPROCESS macro.) 

6 = no option fields used 
1 = option fields used 

7 = not secondary operator control terminal 
1 = secondary operator control terminal 

An example of a single entry follows. 



NAME CCCCCCCC 








TRM hhhhhh STATE/DESTQ hhhhhhhh IN/OUTSEQ hhhhhhhh 


ALTD/DEVFL hhhhhhhh 


STAT hhhhhhhh 


CHCIN/OPNO/OPTBL hhhhhhhh 


NAME ADDR OPTION FIELD 








cccccccc hhhhhh hhhhhhhh 








cccccccc hhhhhh hhhhhhhh 








BUPFSIZE hhhh 








DIAL DIGITS hhhhhhh 








ADDR CHAR hhhhhh 








BLOCK hhhh 








SUBBLOCK hh 








TRANS BLOCK hhhh 








BFDELAY hhhh 








TIME SHARING hhhh 









NAME cccccccc is the name in the termname table of this terminal-table entry. 
TRM hhhhhh is the address of the terminal-table entry. 
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STATE/DESTQ hhhhhhhh 

The first byte is the status byte of the terminal-table entry. The last three bytes 
contain the address of the destination QCB for this entry. 

IN/OUTSEQ hhhhhhhh 

The first two bytes contain the next expected input sequence number. The 
second two bytes contain the next output sequence number to be used. 

ALTD/DEVFL hhhhhhhh 

The first two bytes contain the offset into the terminal table of the alternate 
destination for this entry. The last two bytes are flag bytes used by the internal 
TCAM logic. The bits and their meanings are: 



Bit(s) 


Meaning 





BUFSIZE= specified 


1 


dial digits present 


2 


addressing characters present 


3 


BLOCK= specified 


4 


SUBBLCK= specified 


5 


TRANS = specified 


6 


BFDELAY= specified 


7 


TSO field present 


8-15 


Reserved 



STAT hhhhhhhh is a word for error statistics. 

CHCIN/OPNO/OPTBL hhhhhhhh 

The first byte is the index to the device characteristics table for this entry. The 
second byte gives the number of option fields for this entry. The next two 
bytes contain the offset into the option table for the option fields for this entry. 

NAME ADDR OPTION FIELD cccccccc hhhhhh hhhhhhhh gives a list of the 
names, addresses, and contents of each of the option fields for this entry. 

BUFFSIZE hhhh is the output-buffer size for this entry. This value is given in 
the dump only when a nonzero value has been specified on the BUFSIZE= 
operand of the TERMINAL macro. 

DIAL DIGITS hhhhhhh is the telephone number of this terminal. This field is 
given in the dump only when the CALL= operand of the TERMINAL macro 
has been specified, except where CALL=NONE was specified. 

ADDR CHAR hhhhhh is the addressing characters for the terminal as specified 
on the ADDR= operand of the TERMINAL macro. 

BLOCK hhhh is the number of bytes to be transmitted in each block of data in 
nontransparent mode for messages sent to this terminal. The value corresponds 
to the value specified in the BLOCK= operand of the TERMINAL macro and 
is not given in the dump if the value was not specified. 

SUBBLOCK hh is the number of bytes to be transmitted in each subblock of 
data in nontransparent mode for messages sent to this terminal. The value 
corresponds to the value specified in the SUBBLCK= operand of the TERMI- 
NAL macro and is not given in the dump if the value was not specified. 

TRANS BLOCK hhhh is the number of bytes to be transmitted in each block 
of data in transparent mode for messages sent to this terminal. The value 
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corresponds to the value specified in the TBLKSZ= operand of the TERMI- 
NAL macro and is not given in the dump if the value was not specified. 

BFDELAY hhhh is the number of seconds of delay to be used between mes- 
sage blocks being sent to a buffered terminal. This field is given in the dump 
only if the BFDELAY= operand of the TERMINAL macro has been specified. 

TIME SHARING hhhh is a field used by TSO. In the case that this entry is an 
IBM 2260 or an IBM 2265, the first byte is the number of lines that can be 
displayed and the second byte is the number of characters per line. If the 
terminal is not an IBM 2260 or an IBM 2265, both bytes are zero. This field is 
given in the dump only when TSO is being used. 

An example of a list entry follows. 



NAME CCCCCCCC 




TRM hhhhhh STATE/DESTQ hhhhhhhh 


TLISTCNT hhhh 


LIST ENTRIES 




CCCCCCCC 




CCCCCCCC 





NAME cccccccc is the name in the termname table of this terminal-table entry. 

TRM hhhhhh is the address of the terminal-table entry. 

STATE/DESTQ hhhhhhhh 

The first byte is the status byte of the terminal-table entry. The last three bytes 
contain the address of the destination QCB. 

TLISTCNT hhhh is the number of entries in this distribution or cascade list. 

LIST ENTRIES is a list of the names that appear in the cascade or distribution 
list. 

An example of a line entry follows. 



NAME CCCCCCCC 

TRM hhhhhh STATE/DESTQ hhhhhhhh IN/OUTSEQ hhhhhhhh ALTD/DEVFL hhhhhhhh STAT hhhhhhhh CHCIN/OPNO/OPTBL hhhhhhhh 

NAME ADDR OPTION FIELD 
cccccccc hhhhhh hhhhhhhh 
cccccccc hhhhhh hhhhhhhh 

ADDR CHAR hhhhhh 



NAME cccccccc is the name in the termname table of this terminal-table entry. 

TRM hhhhhh is the address of the terminal-table entry. 

STATE/DESTQ hhhhhhhh 

The first byte is the status byte of the terminal-table entry. The last three bytes 
contain the address of the destination QCB for this entry. 

IN/OUTSEQ hhhhhhhh 

The first two bytes contain the next expected input sequence number. The 
second two bytes contain the next output sequence number to be used. 
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ALTD/DEVFL hhhhhhhh 

The first two bytes contain the offset into the terminal table of the alternate 
destination for this entry. The last two bytes are flag bytes used by the internal 
TCAM logic. The following table is a list of the bits and their meanings. 



Bit(s) 


Meaning 





BUFSIZE= specified 


1 


dial digits present 


2 


addressing characters present 


3 


BLOCK= specified 


4 


SUBBLCK= specified 


5 


TRANS= specified 


6 


BFDELAY= specified 


7 


TSO field present 


8-15 


Reserved 



STAT hhhhhhhh is a word for error statistics. 

CHCIN/OPNO/OPTBL hhhhhhhh 

The first byte is the index to the device characteristics table for this entry. The 
second byte gives the number of option fields for this entry. The next two 
bytes contain the offset into the option table for the option fields for this entry. 

NAME ADDR OPTION FIELDS cccccccc hhhhhh hhhhhhhh gives a list of the 
names, addresses, and contents of each of the option fields for this entry. 

ADDR CHAR hhhh is the addressing characters for the terminal as specified 
on the ADDR= operand of the TERMINAL macro. 

/ 
An example of a process entry follows. V 



NAME CCCCCCCC 

TRM hhhhhh STATE/DESTQ hhhhhhhh IN/OUTSEQ hhhhhhhh ALTD/DEVFL hhhhhhhh STAT hhhhhhhh CHCIN/OPNO/OPTBL hhhhhhhh 

NAME ADDR OPTION FIELD 
cccccccc hhhhhh hhhhhhhh 
cccccccc hhhhhh hhhhhhhh 



NAME cccccccc is the name in the termname table of this terminal-table entry. 

TRM hhhhhh is the address of the terminal-table entry. 

STATE/DESTQ hhhhhhhh 

The first byte is the status byte of the terminal-table entry. The last three bytes 
contain the address of the destination QCB for this entry. 

IN/OUTSEQ hhhhhhhh 

The first two bytes contain the next expected input sequence number. The 
second two bytes contain the next output sequence number to be used. 

ALTD/DEVFL hhhhhhhh 

The first two bytes contain the offset into the terminal-table of the alternate 
destination for this entry. The last two bytes are flag bytes used by the internal 
TCAM logic. The following table is a list of the bits and their meanings. 
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Bit(s) Meaning 

BUFSIZE= specified 

1 dial digits present 

2 addressing characters present 

3 BLOCK= specified 

4 SUBBLCK= specified 

5 TRANS = specified 

6 BFDELAY= specified 

7 TSO field present 
8-15 Reserved 

STAT hhhhhhhh is the address of the process-entry work area (IEDQPEWA) if 
the corresponding application program DCB is opened. 

CHCIN/OPNO/OPTBL hhhhhhhh 

The first byte is the index to the device characteristics table for this entry. The 
second byte gives the number of option fields for this entry. The next two 
bytes contain the offset into the option table for the option fields for this entry. 

NAME ADDR OPTION FIELDS cccccccc hhhhhh hhhhhhhh gives a list of the 
names, addresses, and contents of each of the option fields for this entry. 



TCAM DESTINATION QCB'S 




QCB hhhhhh DSFLG/ELCHN hhhhhhhh PRI/LINK hhhhhhhh 
EOLTD/STAT hhhhhhhh SCBOF/INSRC hhhhhhhh 
RELLN/DCBAD hhhhhhhh FLAG/QBACK hhhhhhhh 


STVTO/STCHN hhhhhhhh STPRI/SLINK hhhhhhhh 
INTVL/MSGCT hhhhhhhh PRLVE/LKRRN hhhhhhhh 


PRIORITY QCB hhhhhh 

DNHDR hhhhhh FHDLZ hhhhhh FHDTZ hhhhhh 
FFEFO hhhhhh LFEFO hhhhhh CFHDR hhhhhh 


INTFF hhhhhh INTLF hhhhhh 
PRIPQ hh CPVHD hhhhhh 



TCAM DESTINATION QCB'S gives the destination QCBs for all of the 
terminal-table entries. These QCBs are used to control the message queuing 
for the terminals in the TCAM system. Each QCB may service one or more 
terminals depending upon the type of queuing specified in the TERMINAL 
macro. Each of these QCBs consists of a master QCB and one or more 
priority-level QCBs. Priority QCBs are generated by the LEVEL= operand of 
the TERMINAL macro. If this operand is omitted, only one priority level QCB 
is generated and its priority is X'OO'. Whether or not the LEVEL= operand is 
specified, the X'OO' priority-level QCB is generated. 

QCB hhhhhh is the starting address of the master QCB. 

DSFLG/ELCHN hhhhhhhh 

The first byte is a flag byte indicating the type of queuing being used by this 
QCB. The next three bytes contain the address of the next element in the 
chain. 



PRI/LINK hhhhhhhh 

The first byte is the priority of this QCB. 
address if the next STCB in the chain. 



The last three bytes contain the 



STVTO/STCHN hhhhhhhh 

The first byte is the index to the entry in the subtask vector table. The last 
three bytes contain the STCB chain. 
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STPRI/SLINK hhhhhhhh 

The first is the priority of the STCB. The last three bytes contain the address 
of the next STCB in the chain. 

EOLTD/STAT hhhhhhhh 

The first two bytes contain the interrupt time used by the time-delay routine. 
The third byte is the LOCK relative line number, and the fourth byte is the 
QCB status byte. 

SCBOF/INSRC hhhhhhhh 

The first byte is the offset to the proper SCB for the current transmission. The 
next three bytes contain the address of the first LCB in the source LCB chain. 

INTVL/MSGCT hhhhhhhh 

The first two bytes contain the value as specified on the CLOCK= or INTVL= 
operand of the TERMINAL macro. The second two bytes contain the count of 
the messages on this queue. 

PRLVL/LKRRN hhhhhhhh 

The first byte is the priority of the highest-priority message in the queue. The 
last three bytes contain the LOCK relative record number. 

RELLN/DCBAD hhhhhhhh 

The first byte is the relative line number for the line that this QCB represents. 
The last three bytes contain the address of the DCB. 

FLAG/QBACK hhhhhhhh 

The first byte is an additional status byte for the QCB. The last three bytes 
contain the QBACK message chain. 

PRIORITY QCB hhhhhh is the address of this priority-level QCB. 

DNHDR hhhhhh is the disk record number assigned to the next header that is 
received. 

FHDLZ hhhhhh is the disk record number of the first header placed in the last 
zone used by this queue. 

FHDTZ hhhhhh is the disk record number of the first header placed in the current 
zone. 

INTFF hhhhhh is the disk record number of the first held message in this queue 
(placed in FEFO order). 

INTLF hhhhhh is the disk record number of the last held message in this queue 
(placed in FEFO order). 

FFEFO hhhhhh is the disk record number of the first message that has not 
been sent (placed in FEFO order). 

LFEFO hhhhhh is the disk record number of the last message that has not been 
sent (placed in FEFO order). 

CFHDR hhhhhh is the main-storage queue address of the first header appear- 
ing in this queue. 
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PRIPQ hh is the priority level of this priority-level QCB. 

CPVHD hhhhhh is the main-storage queue address of the last header appearing in 
this queue. 



TCAM DCB'S 












DCB hhhhhh (LINE GROUP) 












DEVICE INTERFACE 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 




D/S INTERFACE 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 




FOUNDATION 


hhhhhhhh 


hhhhhhhh 


hh 






EXTENSION 






hhhhhh hhhhhhhh hhhhhhhh 




INVITATION LISTS 


hhhhhhhh 










LCB hhhhhh KEY/QCBA 


hhhhhhhh 


PRI/LINK 


hhhhhhhh 


RSKEY/STCBA hhhhhhhh. RSPRI/RSLNK 


hhhhhhhh 


EOLTD/TSOB 


hhhhhhhh 


CHAIN/INSRC 


hhhhhhhh 


SCBO/SCBDA hhhhhhhh ISZE/FSBFR 


hhhhhhhh 


FLAGS/SENSE 


hhhhhhhh 


ECBCC/ECBPT 


hhhhhhhh 


FLAG3/CSW hhhhhhhh 


hhhhhhhh 


SIOCC/START 


hhhhhhhh 


DCBPT 


hhhhhhhh 


RCQCB hhhhhhhh INCAM/ERRCT 


hhhhhhhh 


UCBX/RCBFR 


hhhhhhhh 


RECOF/STATE 


hhhhhhhh 


TSTSW/RECAD hhhhhhhh ERBKY/ERBQB 


hhhhhhhh 


ERBPY/ERBLK 


hhhhhhhh 


ERBST/ERBCH 


hhhhhhhh 


ERBCT/TTCIN hhhhhhhh MSGFM/SCBA 


hhhhhhhh 


ERMSK/INVPT 


hhhhhhhh 


TPCD 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


SNSV/CSWSV 


hhhhhhhh 




hhhhhhhh 


ERCCW hhhhhhhh 


hhhhhhhh 




hhhhhhhh 




hhhhhhhh 


hhhhhhhh 


hhhhhhhh 



TCAM DCBs give the three different types of TCAM DCBs: the line group 
DCBs (along with their related LCBs), the message queues DCBs, and the 
checkpoint DCB. (The message queues DCBs are not given in the dump if the 
TCAM system does not use disk queuing, and the checkpoint DCB is not given 
in the dump if the checkpoint/restart facility is not being utilized.) 

DCB hhhhhh (LINE GROUP) is the starting address of this line group DCB. 

DEVICE INTERFACE 
This section is reserved. 

D/S INTERFACE contains the number of buffers assigned initially for input 
operations, the number of buffers assigned initially for output operations, the 
address of the message handler for this line group, the polling delay interval, the 
program-controlled interruption options, the data set organization, the maximum 
number of buffers to be used at any given time for data transfer for each line in 
the line group, the base for addressing IOBs for the line group (initialized at open 
time), the relative priority of send and receive operations, the address of the 
translation table, the extended IOB index (size of an LCB), and the address of the 
exit list. The following table shows these fields, their relative offsets from the 
beginning of the DCB, their contents, and their size. 



+14 Initial J Initial 
Receive i Send 
Allocation | Allocation 


+15 


Address of the Message Handler 


+18 

Polling Delay Interval 


+19 


PCI Options 


+1 A 

Data Set Organization 


+1C 

Maximum Send or 

Receive Allocation 


+1D 


Open-Base for Addressing IOBs 


+20 Priority of Send/ 

Receive Operations 


+21 


Address of the Translation Table 


+24 

IOB Index 


+25 


Address of the Exit List 



For more detailed information on these fields, see System Control Blocks, 
GC28-6628. 



Appendix C. TCAM Formatted ABEND Dump 201 



FOUNDATION contains fields that are changed during open time. Before open, 
these fields contain the DDNAME character string, the open flags, the IOS error 
flags, and the macro instruction reference. After open, they contain the offset of 
the DD entry from the beginning of the TIOT, the macro instruction reference, 
the IOS error flags, the address of the DEB, and the open flags. The following 
two charts show this area and its contents before and after open. 







Before Open: 








+28 

Tic 




DDNAME character string 




— 


+30 


Open 
flags 


+ 31 IOS error 
flags 


+32 


Macro instruction reference 





Note: During open, the IOS error flags field and the macro instruction 
reference field are relocated and the last three bytes of the last word become 
part of the EXTENSION section. 

After Open: 



+28 Offset of DD entry from 
beginning of the TIOT 


+2A 

Macro instruction reference 


+2C IOS error 
flags 


+2D 

Address of the DEB 


+30 Open 
flags 







For more detailed information on these fields, see System Control Blocks. 

EXTENSION contains the address of the special characters table, the number of 
invitation lists, the number of units for each buffer, the size of all buffers used by 
this line group, and the number of reserve characters. The following example 
shows these fields, their relative offsets from the beginning of the DCB, their 
contents, and their size. 







+31 


Address of the special characters table 


+34 


Number of 
invitation lists 


+35 


Number of units 
per Buffer 


+36 

Buffer size 


+38 






Four one-byte reserve values 



For more detailed information on these fields, see System Control Blocks. 

INVITATION LISTS gives the addresses of the different invitation lists for the 
different lines in the line group. Each list is pointed to by a one-word address. 
These addresses are given in order by relative line number. 

Following each line group DCB is one or more LCBs (line control blocks), which 
are used by the internal TCAM logic to perform line management. The LCBs in 
the dump are given in order by relative line number. 
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LCB hhhhhh is the starting address of this LCB. 

KEY/QCBA hhhhhhhh 

The first byte is the key of this LCB. The next three bytes contain the address 
of its QCB. 

PRI/LINK hhhhhhhh 

The first byte is the priority of this LCB. The next three bytes contain the link 
address to the next element. 

RSKEY/STCBA hhhhhh 

The first byte is the receive scheduler key. The next three bytes contain the 
address of the first STCB when the LCB is a QCB. 

RSPRI/RSLNK hhhhhhhh 

The first byte is the receive scheduler priority. The next three bytes contain the 
address of the next item in the chain. 

EOLTD/TSOB hhhhhhhh 

The first two bytes contain the end-of-polling list, and the time-delay reference 
time. The third byte is the time-delay queue offset to the QCB address (always 
X'14' for an LCB). The fourth byte is a status byte used by TSO. 

CHAIN/INSRC hhhhhhhh 

The first byte is a status byte used by TCAM. The next three bytes contain the 
in-source chain. 

SCBO/SCBDA hhhhhhhh 

The first byte is the offset to the current SCB (station control block). The next 
three bytes contain the address of the SCB directory. 

ISZE/FSBFR hhhhhhhh 

The first byte is the count of reserved idles. The next three bytes contain the 
address of the first buffer assigned to this line. 

FLAGS/SENSE hhhhhhhh is the start of the IOB contained in the LCB. The 
first and second bytes are IOS flags. The last two bytes are the sense bytes. 

ECBCC/ECBPT hhhhhhhh 

The first byte is the ECB completion code. The next three bytes contain the 
address of the ECB. 

FLAG3/CSW 

The first byte is an IOS flag byte. The next seven bytes are the last seven bytes 
of the CSW. 

SIOCC/START hhhhhhhh 

The first byte is the start I/O condition code. The last three bytes contain the 
address of the start of the channel program area. 

DCBPT hhhhhhhh is the address of the DCB for this line. 

RCQCB hhhhhhhh is the address of the QCB to tpost a recalled buffer to IOS. 

INCAM/ERRCT hhhhhhhh are two halfword IOS error counters. 
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UCBX/RCBFR hhhhhhhh 

The first byte is the UCB index. The last three bytes contain the address of a 
recalled buffer or the last buffer serviced by a PCI. 

RECOF/STATE hhhhhhhh 

The first two bytes contain the offset into the current block. The last two bytes 
are the LCB status bytes. 

TSTSW/RECAD hhhhhhhh 

The first byte is a test-and-set switch. The last three bytes contain the address 
of the current message block. 

ERBKY/ERBQB hhhhhhhh 

The first byte is the key of the ERB. The next three bytes contain the address 
of the QCB to which the ERB is tposted. 

ERBPY/ERBLK hhhhhhhh 

The first byte is the priority of this ERB. The next three bytes contain the 
address of the next item in the chain. 

ERBST/ERBCH hhhhhhhh 

The first byte is the ERB status byte. The next three bytes contain the address 
of a chain of assigned buffers. 

ERBCT/TTCIN hhhhhhhh 

The first two bytes contain the count of buffers requested by this ERB. The 
second two bytes contain the index into the termname table of the currently 
connected terminal. 

MSGFM/SCBA hhhhhhhh 

The first byte is used to control BSC lines. The next three bytes contain the 
address of the current SCB. 

ERMSK/INVPT hhhhhhhh 

The first byte is an error-recording mask. The next three bytes contain the 
address of the current entry in the invitation list. 

TPCD is a three-word list of TP operation codes for the CCWs. 

SNSV/CSWSV hhhhhhhh hhhhhhhh 

The first byte is a save area for the sense byte. The last seven bytes comprise a 
save area for the CSW. 

ERCCW is a three-doubleword area for ERP (error-recovery procedure) 
CCWs. 

The following section gives the checkpoint DCB. 



DCB 


hhhhhh 


(CHECKPOINT) 
















DEVICE INTERFACE 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 






D/S INTERFACE 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 






FOUNDATION 


hhhhhhhh 


hhhhhhhh 


hh 










EXTENSION 






hhhhhh 


hhhhhhhh 


hhhhhhhh 



DCB hhhhhh (CHECKPOINT) is the starting address of the checkpoint DCB. 
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DEVICE INTERFACE 
This section is reserved. 

D/S INTERFACE contains the data set organization, the address of the AVT, 
and the address of the exit list. The following table shows these fields, their 
relative offsets from the beginning of the DCB, their contents, and their size. 



+14 






Reserved 


+18 




Reserved 




+1A 

Data set organization 


+1C 


Reserved 




+1D 


Address of the AVT 


+20 






Reserved 


+24 


Reserved 




+25 


Address of the exit list 



For more detailed information of these fields, see System Control Blocks. 

FOUNDATION contains fields that are changed during open time. Before open, 
these fields contain the DDNAME character string, the open flags, the IOS error 
flags, and the macro instruction reference. After open, they contain the offset of 
the DD entry from the beginning of the TIOT, the macro instruction reference, 
the IOS error flags, the address of the DEB, and open flags. The following two 
tables show this area and its contents before and after open. 

Before Open: 



+28 



+2C 



DDNAME character string 



+30 



Open flags 



+31 



IOS error 
flags 



+32 



Macro instruction reference 



Note: During open, the IOS error flags field and the macro-instruction 
reference field are relocated and the last three bytes become part of the 
EXTENSION section. 



+28 Offset of DD entry from 
beginning of the TIOT 


+2A 

Macro instruction reference 


+2C IOS error 
flags 


+2D 

Address of the DEB 


+30 

Open 

flags 







For more detailed information on these fields, see System Control Blocks. 

EXTENSION contains the OPTCD= value of the DCB. The remainder of this 
area is reserved. The following table shows these fields, their relative offsets from 
the beginning of the DCB, their contents, and their size. 
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+31 




Reserved 




+34 


OPTCD=value 


+35 




Reserved 




+38 






Reserved 







For more detailed information on these fields, see System Control Blocks. 
The message queues DCB follows. 



DCB hhhhhh (MESSAGE QUEUE) 

DEVICE INTERFACE hhhhhhhh hhhhhhhh 
D/S INTERFACE hhhhhhhh hhhhhhhh 
FOUNDATION hhhhhhhh hhhhhhhh 
EXTENSION 



hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hh 




hhhhhh 


hhhhhhhh 



hhhhhhhh 
hhhhhhhh 



hhhhhhhh 



DCB hhhhhh (MESSAGE QUEUES) is the starting address of the message 
queues DCB. 

DEVICE INTERFACE 
This section is reserved. 

D/S INTERFACE contains the data set organization, the address of the AVT, the 
threshold value of the percentage of the nonreusable disk message queue records 
to be used before a flush closedown of the system is initiated, and the address of 
the exit list. The following table shows these fields, their relative offsets from the 
beginning of the DCB, their contents, and their size. 



+14 






Reserved 


+18 




Reserved 




+1A 

Data set organization 


+1C 


Reserved 




+1D 


Address of the AVT 


+20 


+21 


Reserved 


+24 


Reserved 




+25 


Address of the exit list 



For more detailed information about these fields, see System Control Blocks. 

FOUNDATION contains fields that are changed during open time. Before open, 
these fields contain the DDNAME character string, the open flags, the IOS error 
flags, and macro instruction reference. After open, they contain the offset of the 
DD entry from the beginning of the TIOT, the macro instruction reference, the 
IOS error flags, the address of the DEB, and open flags. The following two tables 
show this area and its contents before and after open. 



206 OS TCAM User's Guide 







Before Open: 








+28 
~2C 




DDNAME character string 




- 


+30 


Open flags 


+31 IOS error 
flags 


+32 


Macro instruction reference 





+34 



Note: During open, the IOS error-flags field and the macro instruction field 
are relocated and the last three bytes become part of the EXTENSION section. 

After Open: 



+28 Offset of DD entry from 
beginning of the TIOT 


+2 A 

Macro instruction reference 


+2C IOS error 
flags 


+2D 

Address of the DEB 


+30 Open 
flags 







For more detailed information about these fields, see System Control Blocks. 

EXTENSION contains the OPTCD= value of the DCB. The remainder of this 
area is reserved. The following table shows these fields, their relative offsets from 
the beginning of the DCB, their contents, and their size. 



OPTCD=value 



+31 



Reserved 



+35 



Reserved 



+38 



Reserved 



For more detailed information on these fields, see System Control Blocks. 
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Appendix D. Device Configurations Supported by TCAM 




CPU 



2702 I 




IBM 1030 Data Collection System 
IBM 1050 Data Communication System 
IBM 1060 Data Communication System 
IBM 2740 Communication Terminal 
IBM 2740 Model 2 Communication Terminal 
IBM 2741 Communication Terminal 
IBM 2760 Optical Image Unit 
IBM 2260 Display Complex (Remote) 
IBM 2265 Display Complex (Remote) 
AT&T 83B3 Selective Calling Stations 
WU Plan II5A Outstations 
TWX Models 33 and 35 
World Trade Telegraph Terminals 



IBM 2770 Data Communication System 

IBM 2780 Data Transmission Terminal 

IBM 1130 Computing System 

IBM System/360 Model 20 

IBM System/360 Models 25 and above 



IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 

IBM 2741 Communication Terminal 

IBM 2760 Optical Image Unit 

AT&T83B3 Selective Calling Stations 

WU Plan II5A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 



IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

IBM 1060 Data Communication System 

IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 

IBM 2741 Communication Terminal 

IBM 2770 Data Communication System 

IBM 2780 Data Transmission Terminal 

IBM 1130 Computing System 

IBM System/360 Model 20 

IBM System/360 Models 25 and above 

AT&T 83B3 Selective Calling Stations 

WU Plan II5A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 



IBM 2260 Display Complex (Local) 
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Channel Type 


TCU 


Audio 

Response 

Unit 


Line Type 


Notes 


Station Type 


Multiplexer 


Selector 


IBM 2701 
Data Adapter 
Unit 


IBM 2702 

Transmission 

Control 


IBM 2703 

Transmission 

Control 


IBM 7770 
Model 3 


Switched 


Nonswitched 


IBM 1030 Data Collection 
System 


Auto Poll 


X 






X 


X 






X 


The IBM Digital Time Out 
feature cannot be attached 
through an IBM 2701 TCU. 




X 




X 


X 


X 






X 


IBM 1050 Data 
Communication System 


Auto Poll 


X 






X 


X 






X 






X 




X 


X 


X 




X 


X 


IBM 1060 Data 
Communication System 


Auto Poll 


X 






X 


X 






X 






X 




X 


X 


X 






X 


IBM 2260-2848 Display 
Complex (Remote) 




X 




X 










X 




IBM 2260-2848 Display 
Complex (Local) 




X 


X 
















IBM 2265-2845 Display 
Complex (Remote) 




X 




X 










X 




IBM 2740 Model 1 
Communication Terminal 


Auto Poll 


X 






X 


X 






X 


Two Types: 

2740 with station control 
2740 with station control and 
record checking 




X 




X 


X 


X 






X 


Four Types: 

2740 basic 

2740 with station control 

2740 with record checking 

2740 with station control and 

record checking 




X 




X 


X 


X 




X 




Four Types, all with dial: 

2740 

2740 with transmit control 

2740 with record checking 

2740 with transmit control 

and record checking 


IBM 2740 Model 2 
Communication Terminal 


Auto Poll 


X 






X 


X 






X 


Four Types: 

2740 

2740 with record checking 

2740 with buffer receive 

2740 without buffer receive 

(requires line slowdown feature) 




X 




X 


X 


X 






X 


Four Types: 

2740 

2740 with record checking 

2740 with buffer receive 

2740 without buffer receive 


IBM 2741 Communication 
Terminal 




X 




X 


X 


X 




X 


X 


The attention feature is not 
supported, and the break 
feature is supported only if the 
CPU is sending and the terminal 
has not entered data when the 
break is issued. 
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Channel Type 


TCU 


Audio 

Response 

Unit 


Line Type 


Notes 


Station Type 


Multiplexer 


Selector 


IBM 2701 
Data Adapter 
Unit 


IBM 2702 

Transmission 

Control 


IBM 2703 

Transmission 

Control 


IBM 7770 
Model 3 


Switched 


Nonswitched 


IBM 2760 Optical Image 
Unit 
















X 


X 


Attached to a 2740 Model 1 
with record checking 


IBM 2770 Data 
Communication System 




X 




X 




X 




X 


X 


BSC transmission using either 
ASCII or EBCDIC code 


IBM 2780 Data Transmission 
Terminal 




X 




X 




X 




X 


X 


BSC transmission using ASCII, 
EBCDIC, or 6-bit code 


IBM 1130 Computing System 




X 




X 




X 




X 


X 


BSC transmission 


IBM System/360 Model 20 




X 




X 




X 




X 


X 


BSC transmission using either 
ASCII or EBCDIC code 


IBM System/360 Models 25 
and above 




X 




X 




X 




X 


X 


BSC transmission and point-to- 
point lines only 


AT&T 83B3 Selective 
Calling Stations 




X 




X 


X 


X 






X 




Western Union Plan 115A 
Outstations 




X 




X 


X 


X 






X 




TWX Models 33 and 35 




X 




X 


X 


X 




X 




Teletype terminals, dial 
service (8-level code) 


World Trade Telegraph 
Terminals 




X 




X 


X 


X 






X 


Control unit must incorporate 
a WTTA 


Audio terminals 




X 










X 


X 




Example: IBM 2721 Portable 
Audio Terminal 
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Glossary 



accepting: the process in which a destination station acquires 
a message transmitted to it from the central computer. Enter- 
ing and accepting are functions of a station. 

access method: a combination of an access technique (either 
queued or basic) and a given data set organization (for instance, 
sequential, partitioned, indexed sequential, or direct) that 
allows the programmer to transfer data between main storage 
and I/O devices. 

addressing characters: identifying characters, sent by the 
computer, that cause a particular station (or component) to be 
selected to accept a message sent by the computer. 

application program: a user-provided program that processes 
the text portions of messages. Application programs run as- 
ynchronously with the message control program, and are usual- 
ly located in another partition or region of main storage. 
TCAM application programs are optional; there may be many 
or none, depending on the needs of the user. 

available-unit queue: a queue in main storage to which all 
buffer units are assigned initially (that is, before allocation to 
TCAM lines and application programs requiring buffers). 
Empty buffer units (that is, buffer units whose contents have 
been processed by the incoming or outgoing group of an MH, 
and that are not assigned to the main-storage message queues 
data set) are returned to the available-unit queue, from which 
they are reallocated. 

binary synchronous communications (BSC): data trans- 
mission in which character synchronization is controlled by 
timing signals generated by the device that originates a message 
(and the device that obtains the message recognizes the sync 
pattern at the beginning of the transmission — the devices are 
locked in step with one another); contrast with start-stop 
transmission. 

block: that portion of a message terminated by an EOB or 
ETB line-control character or, if this is the last block in the 
message, by an ETX or EOT line-control character. When 
end-of-block checking is specified in the STARTMH macro, 
messages are checked for certain types of transmission and 
user-specified logical errors on a block-by-block basis. 

buffer: an area in main storage into which a message segment 
is read, or from which a message segment is written. Buffers 
are temporary data-holding areas that are used to compensate 
for the difference between the rate at which data can be entered 
from or accepted by a station and the rate at which it can be 
processed by the central processing unit; buffers also may be 



used as work areas in TCAM. The size of TCAM buffers is 
designated by the user. (See also hardware buffer.) 

buffer allocation: the assignment of buffers by TCAM to 
lines or application programs in preparation for reception of 
message segments from stations on the lines or from application 
programs. (See also dynamic buffer allocation and static buff- 
er allocation.) 

buffer deallocation: for a sending operation, deallocation 
consists of returning the units that compose the buffer to the 
available-unit queue after the data in these units has been sent 
to its destination station or application program; for a receiving 
operation, deallocation consists of transferring full buffers from 
the line or application program to which they were assigned to 
the incoming group of the MH that is to process the message 
segments they contain. 

buffer prefix: a control area contained within each TCAM 
buffer. The prefix for the buffer containing the first segment of 
a message is 30 bytes, while the prefix for each buffer contain- 
ing a subsequent segment of the message is 23 bytes. The user 
must allow room for the buffer prefix when he specifies his 
buffer size. TCAM fills the prefix area with buffer control 
information. 

buffer unit: the basic building block from which TCAM buff- 
ers are constructed. All units in a particular TCAM system are 
the same size; this size is specified by the KEYLEN= operand 
of the INTRO macro. 

buffer-unit pool: all the buffer units in a particular TCAM 
system together constitute the buffer-unit pool for that system. 
The number of units in the pool is equal to the sum of the integ- 
ers specified by the LNUNITS= and MSUNITS= operands of 
the INTRO macro. 

buffered terminal: a terminal having a hardware buffer. As 
used in this book, a buffered terminal is an IBM 2740 Model 2 
station or IBM 2770 station whose TERMINAL macro specifies 
BFDELAY=integer. When the BFDELAY= operand of TER- 
MINAL is coded, messages are sent to the station segment-by- 
segment; after a segment is sent, the message control program 
pauses before sending the next segment to allow the station's 
buffer to empty. During this pause, the MCP may send seg- 
ments to other stations on the line. 

central processing unit (CPU): a unit of a computer that 
controls interpretation and execution of instructions. 

channel program block (CPB): a TCAM control block used 
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in the transfer of the data between buffer units and message 
queues maintained on disk. The CPB= operand of the INTRO 
macro specifies the number of CPBs to be provided in a TCAM 
system. 

checkpoint data set: an optional TCAM data set that con- 
tains the checkpoint records used to reconstruct the MCP envi- 
ronment after closedown or system failure, when the TCAM 
checkpoint/restart facility is utilized. 

checkpoint records: records, located in the checkpoint data 
set, that are used to reconstruct the MCP environment upon 
restart following closedown or system failure. The four types of 
checkpoint records are: environment records, incident records, 
checkpoint request records, and a control record. 

checkpoint request record: a checkpoint record taken as a 
result of execution of a CKREQ macro issued in an application 
program: the record contains the status of a single destination 
queue for the application program. The latest checkpoint re- 
quest record for a message queue is used during restart to cause 
sending from that queue to the application program to begin 
with the message that follows the last message sent to the pro- 
gram from that queue at the time the checkpoint request record 
was taken, rather than with the message following the last 
message marked serviced. 

checkpoint/restart: a TCAM facility that records the status 
of the teleprocessing network at designated intervals or follow- 
ing certain events. Following system failure or closedown, the 
checkpoint/restart facility uses the records it has taken to re- 
store the message control program environment as nearly as 
possible to its status before the failure or closedown. 

closedown: an orderly deactivation of the MCP by either an 
MCPCLOSE macro instruction issued in an application pro- 
gram or an operator command. See quick closedown and flush 
closedown. 

cold restart: start-up of a TCAM message control program 
following either a flush closedown, a quick closedown, or a 
system failure. A cold restart ignores the previous environment 
(that is, the MCP is started as if this were the initial start-up), 
and is the only type of restart possible when no 
checkpoint/restart facility is used. 

component: an I/O device associated with a station. 

computer: in this publication, the central processing unit in 
which the TCAM message control program is located. 

continuation restart: a restart of the TCAM message control 
program following termination of the message control program 
because of system failure; the TCAM checkpoint/restart facility 
restores the MCP environment as nearly as possible to its condi- 
tion before failure. 



control characters: characters transmitted over a line that are 
not message data, but which cause certain control operations to 
be performed when encountered by the computer, transmission 
control unit, or station; among such operations are polling and 
addressing, message delimiting and blocking, transmission- 
error checking, and carriage return. 

control record: a record, included in a checkpoint data set, 
that keeps track of the correct environment, incident, and 
checkpoint request records to use for reconstructing the mes- 
sage control program environment during restart. 

data control block (DCB): an area of main storage that 
serves as a logical connector between the problem program and 
a data set. The data control block also can provide control 
information for any transfer of data. A data control block must 
be created for each TCAM data set except a message queues 
data set residing in main storage; a DCB macro instruction 
creates a data control block. 

data set: 

1. a named, organized collection of logically related records 
(program data set). The information is not restricted to a 
specific type, purpose, or storage medium. Among the data 
sets specifically related to TCAM are the line group data 
sets, the message queues data sets, the checkpoint data set, 
the message log data set, and the input and output data sets 
for a TCAM-compatible application program. 

2. a device containing the electrical circuitry necessary to 
connect data processing equipment to a communication 
channel; also called a subset, Data-Phone*, 
modulator/demodulator, or modem. 

dead-letter queue: the destination queue for the station or 
application program named by the DLQ= operand of the IN- 
TRO macro instruction. If an invalid destination is detected in 
a message header by a FORWARD macro instruction, and if no 
user exit is specified in the FORWARD macro, that message is 
sent to the dead-letter queue. 

delimiter macro instruction: a TCAM macro instruction that 
classifies and identifies sequences of functional macro instruc- 
tions and directs control to the appropriate sequence of func- 
tional macro instructions. 

descriptor code: under Multiple Console Support, indicates 
the means of message presentation and message deletion on 
display devices. 

destination: the place to which a message being handled by a 
TCAM message handler is to be sent. A destination may be 
either a station defined by a TERMINAL macro, a group of 
stations defined by a TLIST macro, or an application program 
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defined by a TPROCESS macro. One or more destinations 
may be specified in fields of the message header that are 
checked by a FORWARD macro, or a single destination may be 
specified for all messages handled by a particular inheader 
subgroup by means of the DEST= operand of a FORWARD 
macro issued in that subgroup. 

destination field: a field in a message header containing the 
name of a station or application program to which a message is 
directed. 

destination queue: a queue on which messages bound for a 
particular destination are placed after being processed by the 
incoming group of a message handler. A separate destination 
queue is created for each station defined by a TERMINAL 
macro specifying queuing by terminal; one for each line whose 
stations are defined by TERMINAL macros specifying queuing 
by line; and one for each application-program process entry 
(defined by a TPROCESS macro) to which the application 
program may direct GET or READ macros. Destination 
queues are maintained in message queues data sets, which may 
be located on disk or in main storage. Queuing messages by 
destination permits overlap of line usage in I/O operations. See 
also process queue. 

destination station: a station that accepts a message sent to it 
by the outgoing group of the message handler that is specified 
for the line to which the accepting station is assigned. 

distribution entry: an entry in the terminal table associated 
with a distribution list. A distribution entry is created by a 
TLIST macro. 

distribution list: a list of single, group, cascade, or process 
entries; when a message is directed to the distribution entry 
associated with this list, TCAM sends the message to each 
destination named in the list. 



entering: the process in which a station places on the line a 
message to be transmitted to the central computer (a station 
enters and accepts messages, while a computer sends and receives 
messages). 

environment record: a record of the total teleprocessing 
environment at a single point in time. The environment record 
resides in the checkpoint data set; at restart time, an environ- 
ment record is updated by the contents of incident records that 
were taken after the environment record was taken, and the 
updated environment record is then used to reconstruct the 
message control program environment as it existed before MCP 
closedown or system failure. 

error-recovery procedures (ERP): a set of internal TCAM 
routines that attempt to recover from transmission errors. 

FEFO (first-ended first-out): a queuing scheme whereby 
messages on a destination queue are sent to the destination on a 
first-ended first-out basis within priority groups. That is, higher- 
priority messages are sent before lower-priority messages; when 
two messages on a queue have equal priority, the one whose 
final segment arrived at the queue earliest is sent first. 

FIFO (first-in first-OUt): a queuing scheme whereby equal- 
priority messages on the same destination queue are sent in the 
order that their first segments arrived at the queue. 

flush closedown: a closedown of the TCAM message control 
program during which incoming message traffic is suspended 
and queued outgoing messages are sent to their destinations 
before closedown is completed; this form of termination is 
known as a flush closedown because unsent messages are 
flushed from the message queues. See also quick closedown. 

folded table: a table that recognizes as valid either uppercase 
or lowercase characters. 



dynamic buffer allocation: the assignment of buffers to a 
line on an as-needed basis, after a message has started coming 
in over the line. Dynamic allocation occurs following program- 
controlled interruptions, and is specified by the PCI= operand 
of the line group DCB macro. See also static buffer allocation. 

end-of-address (EOA) character: 

1 . a hardware generated line-control character or characters 
transmitted on a line to indicate the end of nontext charac- 
ters (for example, addressing characters). 

2. a TCAM character that must be placed in a message if the 
system is to accommodate routing of that message to several 
destinations; the character must immediately follow the last 
destination code in the message header; and must also be 
specified by the EOA= operand of the FORWARD macro 
for the message. 



functional macro instructions: TCAM macros that perform 
the specific operations required for messages directed to the 
message handler. See also delimiter macro instructions. 

group entry: an entry in the terminal table associated with a 
group of terminals having the group-addressing hardware fea- 
ture. 

hardware buffer: a buffer that is located in a station, as op- 
posed to the buffers for the TCAM MCP, which are located in 
the computer. The IBM 2740 Communication Terminal Model 
2, for example, contains a hardware buffer that accommodates 
up to 120 characters. See also buffered terminal. 

header: that portion of a message containing control informa- 
tion for the message; a header might contain one or more desti- 
nation fields, the name of the originating station, an input 



Glossary 215 



sequence number, a character string indicating the type of 
message, a priority level for the message, etc. The message 
header is operated on by macros in the inheader and outheader 
subgroups of the message handler. 

header buffer: a buffer containing a header segment. 

header segment: a message segment containing all or part of 
the message header. 

identification characters (ID characters): characters sent 
by a BSC station on a switched line to identify the station. ID 
characters can also be assigned to the computer (by the 
CPUID= operand of the INVLIST macro); in this case, the 
computer and the station can exchange ID sequences. TWX 
stations also use ID characters. 

idle: describes a line that is not currently available for trans- 
mission of data because IDLE was coded in the OPEN macro 
for the line group data set containing the line. Such a line may 
be activated by a STARTLINE operator command. 

inactive Station: a station that is currently ineligible for enter- 
ing and/or accepting messages. A station may be inactive for 
entering or inactive for accepting, or both; the status of a sta- 
tion is determined by the status of the line it is on, by a special 
character ( + or -) coded in the invitation-list entry for the 
station, by the presence or absence of a HOLD macro in the 
outgoing group of the message handler handling outgoing mes- 
sages for this station, and by the five operator commands 
(ACTVBOTH, ENTERING, NOENTRNG, NOTRAFIC, 
SUSPXMIT) that directly affect the station's status. 

incident record: a checkpoint record residing in the check- 
point data set on a DASD; an incident record logs a change in 
station status or in the contents of an option field that occurred 
since the last environment record was taken. Incident records 
update the information contained in environment records at 
restart time after a closedown or system failure. 

incoming group: that portion of a message handler designed 
to handle messages arriving for handling by the message control 
program. See also outgoing group. 

incoming message: a message being transmitted from a sta- 
tion to the computer. 



for its definition and must be activated and deactivated by 
OPEN and CLOSE macros. See also output data set. 

input sequence number: a means of ensuring that messages 
are received from a source in the correct order; the user may 
place a sequence number in the header of each message entered 
by a station or application program, and code a SEQUENCE 
macro in the incoming group of his message handler. The 
SEQUENCE macro checks the sequence number for each 
message; if the number is not one more than that assigned to 
the previous message received from that origin, a bit is turned 
on in the message error record. 

inquiry processing: a TCAM application in which the mes- 
sage control program receives a message from a station, then 
routes it to an application program that processes the data in 
the message and generates a reply; the reply is routed by the 
message control program to the inquiring station. Response 
time often may be shortened by specifying lock mode (by a 
LOCK macro in the message handler) and by locating the mes- 
sage queues data set containing the queues for the application 
program in main storage. 

intercepted station: a station to which no messages may be 
sent. A station is intercepted by issuing a HOLD macro instruc- 
tion in the outmessage subgroup of a message handler; the 
suspension is either for a specified time interval or until either 
an operator command or an application-program macro 
instruction-is issued to release messages held for the intercepted 
station. 

invalid destination: a destination specified for a message that 
does not correspond to a valid terminal-table entry. 

invitation: the process in which the computer contacts a sta- 
tion in order to allow the station to transmit a message if it has 
one ready. 

invitation delay: a period of time during which invitation is 
suspended to allow transmission of outgoing messages for lines 
whose line group DCB has CPRI=R specified. This delay is 
observed for all such stations on a line when the end of the 
invitation list for that line is reached. The delay in polling is 
observed for such stations whether or not the computer has any 
messages to send them. If no invitation delay is specified for 
such stations, no messages can be sent to them. 



input: of or related to a message transmission that involves 
entering data at a station or receiving data at the computer. 

input data set: a logical data set for a TCAM-compatible 
application program. The input data set contains all messages 
or records being sent to the application program from a single 
process queue. Though it is not located in a physical medium, 
the input data set requires a DD statement and a DCB macro 



invitation list: a series of sets of polling characters or identifi- 
cation sequences associated with the stations on a line; the 
order in which sets of polling characters are specified (in the 
INVLIST macro for the line) determines the order in which 
polled stations are invited to enter messages on the line. 

line: the communications medium linking the computer to one 
or more remote stations; message transmission occurs over this 
medium. 
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line control: the scheme of operating procedures and control 
signals hy which a telecommunications system is controlled. 

line control block (LCB): an area of main storage contain 
ing control information for operations on a line; one LCB is 
maintained by TCAM for each line in the system. 

line-control characters: characters that control transmission 
of data over a line or control the state of the devices on the line; 
for example, line-control characters delimit messages, cause 
transmission-error checking to be performed, and indicate 
whether a station has data to send or is ready to receive data. 

line group: a set of one or more communications lines of the 
same type, over which stations with similar characteristics can 
communicate with the computer. 

line group data set: a message control program data set 
consisting of all the lines in a line group; the messages that are 
transmitted on these lines constitute the data in this data set. A 
line group data set is defined by a line group DCB macro in- 
struction, and by a DD statement for each line in the line group. 

line group DCB: a data control block created by a line group 
DCB macro instruction; information in the data control block 
defines the line group to TCAM. 

local station: a station whose control unit is connected direct- 
ly to a computer data channel by a local cable. See remote 
station. 

lock mode: a TCAM facility, invoked in a message handler by 
the LOCK macro, whereby a station entering an inquiry mes- 
sage for an application program is held on the line by the mes- 
sage control program until a response has been returned to it by 
the application program. Using lock mode decreases response 
time because there are no interruptions on the line before a 
response is returned. If LOCK is executed and CONV=YES is 
coded in the STARTMH macro, lock mode is in effect for the 
station. A station may be placed in lock mode either for the 
duration of a single inquiry and response ( message lock mode) 
or for the duration of several inquiry-response cycles ( extended 
lock mode). The type of lock mode is specified in the LOCK 
macro. 



macro instructions defining the line group data sets, the mes- 
sage queues data sets, and the checkpoint data set. 

Iogtype entry: an entry in the terminal table associated with a 
queue on which complete messages reside while awaiting trans- 
fer to the logging medium (a Iogtype entry is not needed if 
message segments only are to be logged). A Iogtype entry is 
created by a LOGTYPE macro. 

message: a unit of data received from or sent to a station that 
is terminated by an EOT or ETX control character or, if the 
CONV= operand of the STARTMH macro is coded 
CONV=YES, by an EOB or ETX control character. A TCAM 
message is often divided into a header portion, which contains 
control information, and a text portion, which contains the part 
of the message of concern to the party ultimately receiving it. 

message control program (MCP): a set of user-defined 
TCAM routines that identifies the teleprocessing network to the 
System/360 Operating System, establishes the line control 
required for the various kinds of stations and modes of connec- 
tion, and controls the handling and routing of messages to fit 
the user's requirements. 

message error record: five bytes assigned to each message 
being processed by a message handler; these bytes indicate 
physical or logical errors that have occurred during transmis- 
sion on the line or during subsequent processing or queuing of 
the message, and are checked by error-handling macros in the 
inmessage and outmessage subgroups of a message handler. 

message handler (MH): a sequence of user-specified TCAM 
macro instructions in the message control program that exam- 
ine and process control information in message headers, and 
perform functions necessary to prepare message segments for 
forwarding to their destinations. One message handler must be 
assigned to each line group by the MH= operand of the line 
group DCB macro, and one must be assigned to each TCAM- 
compatible application program by the MH= operand of the 
PCB macro. The incoming group of an MH handles messages 
received from either an originating station or an application 
program; the outgoing group of an MH handles messages be- 
fore their being sent to a destination station or application 
program. 



log: a collection of messages or message segments placed on a 
secondary-storage device foraccounting or data collection 
purposes. The TCAM logging facility is invoked by a function- 
al macro instruction issued in a message handler. 

log data set: a data set consisting of the messages or message 
segments recorded on a secondary-storage medium by the 
TCAM logging facility. A log data set is defined by means of a 
BSAM DCB macro instruction that is issued with the DCB 



message priority: refers to the order in which messages in a 
destination queue are transmitted to the destination, relative to 
each other. Higher-priority messages are forwarded before 
lower-priority messages. Up to 255 different priority levels may 
be assigned to a single destination (by the LEVEL= operand of 
the TERMINAL or TPROCESS macro). The priority for each 
message sent to the destination may be specified in the message 
header or assigned by a PRIORITY macro; in either case, a 
PRIORITY macro should be coded in the inheader subgroup 
handling the message. 
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message queue: see destination queue. 

message queues data set: a TCAM data set that contains one 
or more destination queues. A message queues data set con- 
tains messages that have been processed by the incoming group 
of a message handler and are waiting for TCAM to dequeue 
them, route them through an outgoing group of a message 
handler, and send them to their destinations. Up to three mes- 
sage queues data sets (one in main storage, one on reusable 
disk, one on nonreusable disk) may be specified for a TCAM 
message control program. 

message segment: the portion of a message contained in a 
single buffer. 

message switching: a telecommunications application in 
which a message is received from a remote station, stored until 
a suitable outgoing line is available, and then transmittted to its 
destination station. TCAM message switching can be handled 
entirely by the message control program. 

nontransparent mode: a mode of binary synchronous trans- 
mission in which all control characters are treated as control 
characters (that is, not treated as text). See transparent mode. 

on-line test (OLT): an optional TCAM facility that permits 
either a system console operator or a remote-station operator to 
test transmission control units and remote stations to find out if 
they work properly. 

operator command: a command entered either at an operator 
control station or at the system console to examine or alter the 
status of the telecommunications network during execution. 

operator control station: a station eligible to enter operator 
commands. An application program and the system console 
may also serve as operator control stations. Operator control 
stations are designated as such by the PRIMARY= operand of 
the INTRO macro and by the SECTERM= operand of the 
TERMINAL and TPROCESS macros. 

option field: a storage area containing data relating to a par- 
ticular station, component, line, or application program; cer- 
tain message handler routines that need source- or destination- 
related data to perform their functions have access to data in an 
option field. User-written routines also have access to data in 
an option field. Option fields are defined by OPTION macros 
and initialized for each station, line, component, or application 
program by the OPDATA= operand of the TERMINAL or 
TPROCESS macro. 

origin: a station or application program from which a message, 
or other data originates. See also destination. 

outgoing group: that section of a message handler that manip- 



ulates outgoing messages after they have been removed from 
their destination queues. The outgoing group has three types of 
subgroup — the outheader subgroup, which executes on outgoing 
header segments; the outbuffer subgroup, which executes on 
each outgoing segment; and the outmessage subgroup, which 
executes on the entire message. See also incoming group. 

output data set: a logical data set for a TCAM-compatible 
application program. The output data set contains the mes- 
sages or records returned from the application program to the 
message control program by a process entry in the terminal 
table. An output data set is defined by a DD statement and a 
DCB macro, and must be activated and deactivated by OPEN 
and CLOSE macros. See also input data set. 

output DCB: a data control block created by an output DCB 
macro. One output DCB is required for each output data set. 

output sequence number: a number placed in the header of a 
message by TCAM that determines the order in which messages 
were sent to a destination by the computer. When specified in 
an outheader subgroup, the SEQUENCE macro causes an 
output sequence number to be placed in the header of each 
outgoing message; this sequence number is one greater than the 
sequence number for the last message sent to this destination. 
See also input sequence number. 

polling: a non-contention line management method whereby 
the computer invites stations to enter messages. The computer 
contacts stations in the order specified by the invitation list; 
each station contacted is invited to enter messages. 

polling characters: a set of identifying characters peculiar to 
either a station or a component of that station; a response to 
these characters indicates to the computer whether the station 
has a message to enter. 

priority: see message priority and transmission priority. 

problem determination: The act of pointing to the malfunc- 
tioning hardware unit or program and ultimately determining 
who has the responsibility for fixing the trouble. 

process queue: a destination queue for an application pro- 
gram (see destination queue). A process queue is defined by a 
TPROCESS macro. 

queue: a set of items consisting of: 

1. a queue control block (an area in main storage containing 
control information for the queue), and 

2. one or more ordered arrangements of items (the items may 
be messages, main-storage addresses, etc.). 

quick closedown: a closedown of the TCAM message control 
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program that entails stopping message traffic on each line as 
soon as transmission is complete for any messages being sent or 
received at the time of the request for closedown. 

read-ahead queue: an area of main storage in which the 
message control program plans work units in advance of their 
being requested by the application programs. 

receiving: the process in which the central computer obtains a 
message from a remote station (the message is entered by the 
station). Receiving and sending are functions of the central 
computer. 

record: a logical unit of data, the length of which is defined by 
the user through the use of operands on the input or output 
DCB macro and delimiting characters in the message. 

relative line number: a number assigned by the user to a 
communications line of a line group at system generation time 
or MCP execution time. If a line group is defined at system 
generation time by a UNITNAME macro, the lines in the group 
are assigned relative line numbers according to the order in 
which their hardware addresses are specified in the UNIT= 
operand of UNITNAME; the line whose address is specified 
first is relative line number one, that address specified second is 
relative line number two, etc. If a line group is defined at MCP 
execution time by concatenated DD statements, the order in 
which the DD statements for the lines in the line group are 
arranged determines the relative line numbers for the lines. 
The line whose DD statement appears first is relative line num- 
ber one, the statement that appears second is relative line num- 
ber two, etc. 



sequence number: see input sequence number and output 
sequence number. 

single entry: an entry in the terminal table associated with a 
single station or station component; one such entry must be 
created (by a TERMINAL macro) for each station in the 
TCAM system not defined by a group entry. 

start-stop transmission: data transmission in which each 
character being transmitted is preceded by a special control 
signal indicating the beginning of the sequence of data bits 
representing the character, and is followed by another control 
signal indicating the end of the data-bit sequence (character 
recognition by the device that obtains the data depends on the 
presence of these control signals for each character); contrast 
with binary synchronous communications. 

Static buffer allocation: the assignment to a line, before 
transmission over that line, of all buffers to contain the trans- 
mitted data. When PCI=N or PCI = R is coded in the line group 
DCB macro, the number of buffers specified by the BUFIN= or 
BUFOUT= operand of the line group DCB macro instruction is 
assigned to a line before incoming or outgoing transmission 
begins on that line; once transmission has started, no more 
buffers are available to handle the data involved in the trans- 
mission. 

station: either a remote terminal, or a remote computer used 
as a terminal. 

subblock: that portion of a BSC message terminated by an 
ITB line-control character. 



remote Station: a station that is connected to a computer data 
channel through either a transmission control unit, an audio 
response unit or common carrier facilities. See also local 
station. 

retry: an error-recovery procedure in which the current block 
of data (from the last EOB or ETB) is re-sent a prescribed 
number of times, or until accepted or entered correctly. 

routing code: under Multiple Console Support, indicates the 
consoles to which the messages should be sent. 

segment: the portion of a TCAM message contained in a 
single buffer. 

selection: the process whereby the computer contacts a re- 
mote station to send it a message. 

Sending: the process in which the central computer places a 
message on a line for transmission to a station (the station 
accepts the message). Sending and receiving are functions of 
the central computer. 



switched line: a communications line on which the connection 
between the computer and a remote station is established by 
dialing. Also known as a dial line. 

symbol: in assembler language, a character or character string 
used to represent addresses or arbitrary values. A symbol must 
meet the following requirements: 

1 . A symbol may consist of no more than eight characters, the 
first character being a letter (A through Z, $, #, or @), and 
the other characters being either letters or digits. 

2. No blanks or special characters are allowed in a symbol. 

system interval: a user-specified time interval during which 
polling and addressing are suspended on multipoint lines to 
polled stations. The system interval is specified by the 
INTVAL= operand of the INTRO macro, and may be changed 
during TCAM initialization, by a SYSINTVL operator com- 
mand. The INTERVAL operator command tells TCAM to 
begin the system interval. The system interval minimizes un- 
productive polling, minimizes CPU meter time, and synchron- 
izes polling on the polled lines in the system. See also invitation 
delay. 
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terminal table: an ordered collection of information consist- 
ing of a control field for the table and blocks of information on 
each line, station, component, or application program from 
which a message can originate or to which a message can be 
sent. 



transparent mode: a mode of binary synchronous transmis- 
sion in which all data, including normally restricted data-link 
control characters, is transmitted only as specific bit patterns. 
Control characters that are intended to be effective are preced- 
ed by a DLE character. 



text: that part of the message of concern to the party ultimate- 
ly receiving the message (that is, the message exclusive of the 
header, or control, information). 

text segment: a portion of a message that contains no part of 
the message header. 

transmission: the transfer of coded data by an electromagnet- 
ic medium between two points in a telecommunications net- 
work. 

transmission control unit (TCU): a control unit that serves 
as an interface between communications lines and a computer 
for logical operations. The transmission control units support- 
ed by TCAM are the 2701 Data Adapter Unit Model 1, the 2702 
Transmission Control Model 1, and the 2703 Transmission 
Control Model 1. 

transmission priority: refers to the order in which sending 
and receiving occur, relative to each other, for a particular 
station. Transmission priority is specified on a line-group basis 
by the CPRI= operand of the line group DCB macro. The three 
transmission priorities possible in TCAM are send priority, 
equal priority, and receive priority. The exact meaning of each 
priority depends upon the line configuration and type of sta- 
tion. See also message priority. 



unit: see buffer unit. 

warm restart: a restart of the TCAM message control pro- 
gram following either a quick or a flush closedown; the TCAM 
checkpoint/restart facility restores the MCP environment as 
nearly as possible to its condition before failure. See 
checkpoint/restart. 

work area: an area of storage related to an application pro- 
gram that receives messages or records transferred to the appli- 
cation program from the message control program by GET or 
READ macros, and from which messages or records are trans- 
ferred to the MCP by PUT or WRITE macros. The size of the 
work area must be specified in the BLKSIZE= operand of the 
input or output DCB macro associated with the data set whose 
contents are being transferred to or from the work area. A 
work area may be defined either statically (by a DC or DS 
assembler instruction) or dynamically (by specifying locate 
mode in the MACRF= operand of the input DCB macro). 

work unit: the amount of data transferred from the message 
control program to an application program by a single GET or 
READ macro, or transferred from an application program to 
the MCP by a single PUT or WRITE macro. The work unit 
may be a message or a record (or, for QTAM-compatible appli- 
cation programs, a segment). 



220 OS TCAM User's Guide 



Index 



ABEND 75 
activation of TCAM 52 

finding problems in 52 — 54 

typical errors 53 
aids 

coding 17 

diagnostic 75 

problem determination 39 

service 110 
ALTDEST= operand 40, 44 
application program 12 

checking return codes in 43 

checklist 28, 43 

closing 40 

coding conventions 39 — 41 

coding hints 23 

examining 39 

how to code 23 

interface definition 12 

interface with MCP 12 

issuing operator commands from 40 

macro instructions 14 

MH macros that affect 41 — 42 

non-TCAM macros in 41 

problems 39 

support 12 

typical errors 43 

ways to run 12,40 

work areas in 41 
ATTACH macro 15 
AVT, finding 76, 85 



BLANK= operand 69 
buffer 

allocating dynamically 47 

allocating statically 47 

defining 9, 46 

definition checklist 17,19 

finding current 85 

finding problems in 46 

macros and operands to define 1 9 

reasons for large 46 

reasons for small 46 — 47 

typical errors 49 
buffer allocation 

reasons for dynamic 10,47 

reasons for static 47 
buffer prefix 135 — 136 
buffer trace 132 

activating 132 

entry format 133 

field meanings 133 — 135 

formatted table 135 

how to dump 132 

how to print 132 

how to read 1 32 — 1 3 3 

when to dump 132 

when to use 132 
buffer units 46 

line unit/buffer considerations 48 

reasons for large 46 

reasons for less 46 

reasons for more 47 

reasons for small 47 

TCAM unit-pool analysis 21 — 22 
BUFIN= operand 48 
BUFMAX= operand 48 
BUFOUT= operand 48 
BUFSIZE= operand 49 



35 



CANCELMG macro 

reasons to use 35 

restrictions 35 
channel program block (CPB) 

availability 50 

coding considerations 50 



50 



CHAP macro 40 
checklist 

application program 28, 43 

buffer definition 17,19 

checkpoint/restart 25 

diagnostic aids 27 

MCP arrangement 18 

message queues data set 24 

operator control 26 
checkpoint/restart 13, 98 

checklist 25 
checkpoint/ restart data set 

coding considerations 23 

defining 23 

how to dump 98 

macros and operands 25 

when to dump 98 
CLOSE macro 8 

coding considerations 53 
closedown 

abnormal end 75 

flush close 8 

normal end-of-day 145 

quick close 8 
CODE macro 41 
coding considerations 

channel program blocks 50 

checkpoint/restart data set 25 

CLOSE macro 53 

functional macros 62 

INTRO macro 6, 52 

line group 49 

OPEN macro 52 

TERMINAL macro 44 
cold start 8 
commands, operator 

CANCEL 40 

DEBUG 72,112 

ERRECORD 101 

GOTRACE 72, 1 1 1 

NOTRACE 72, 1 1 1 

RESMXMIT 34 

START 145 

SUSPXMIT 35 

SYSCLOSE 8 
COMWRITE routine 14 
COMWRTE= operand 1 10 
configurations, device 209 — 211 
console listings 140 

how to use 140 

when to use 140 
CONT= operand 33 
continuation start 8 
CONTROL= operand 57 
CONV= operand 33 
core queue 79 
COUNTER macro 41 
CPB (see channel program block) 
CPB= operand 52 
cross-reference table 138 

entry format 139 

example 140 

finding in a stand-alone dump 86,139 

when to dump 1 38 — 1 39 

when to use 138 — 139 
CROSSREF= operand 52 
current buffer, finding 132 — 138 
CUTOFF macro, reasons to use 34 



data control block (see DCB) 

data, gathering and interpreting from dumps 

data sets 

defining 49 

disk 49,91 

finding problems in 49 

log 38, 98 

log message 100 



75 



Index 221 



message queues 93 

typical errors 51 
DATETIME macro 50,59 
DCB (data control block) 39 

finding 86 
DD statements, for line group 50 
deactivation 52 

finding problems in 52 — 54 

typical errors 53 — 54 
delimiter macros 56 
DEST= operand 31,40 
destination QCBs 80 
device configurations 209 — 211 
device (outboard) records 103 
diagnostic aids 

checklist 27 

macros and operands 23 
disk 79 
disk data set 

defining extent 91 

dump utility (IEDQXB) 99 

Preformatting 50 

preformat utility (IEDQXA) 50 
DISK= operand 52 
disk message queues 90 

dump of 90 

when to dump 90 
disk queues 

dumping specific 92 

finding number of 92 

nonreusable 54 

reusable 55 
DISP= operand 51 
dispatcher ready queues 77 
DLQ= operand 52 
DTRACE= operand 52 
dump 

checkpoint/restart 98 

disk message 90 

high-speed 84 

log data set 98 

log message 100 

log segment 99 

low-speed 84 

main-storage 75 

message queues data set 90 

OBR/SDRfile 101 

printing formatted dump utility (IEDQXC) 

reading the 76 

secondary storage 90 

stand-alone 84 

TCAM formatted ABEND 179 

TCAM libraries 109 

using the 81 
dynamic buffer allocation 47 



ECB (event control block) 78 
element request block (ERB) 122,134 
end-of-day closedown 

how to obtain 145 

why to obtain 145 
end-of-day recording 107 

how to read 108 

when to use 108 
end-of-day records 109 
EODAD= operand 40 
ERB (see element request block) 
ERRORMSG macro 35 

advantages of using 35 — 36 

compared with MSGGEN macro 36 — 37 

exit routine 36 
error records (see I/O error records) 
errors 

finding in messages 29 

recorded in the message error record 29 
EXIT= operand 32 



90 



54 



FEATURE= operand 
flush close 8 
folded table 50 
formatted dump 75,179 
fields in 76—81 



how to read 76 

how to use 75 

obtaining 75 

when to use 76 
formatted buffer trace table 135 
formatted line I/O interrupt trace table 
formatted subtask trace table 127 
FORWARD macro 32 
functional macros 62 

coding considerations 62 — 65 



GET macro 8 



hardware problems 29 
high-speed dump 84 
HOLD macro 

reasons to use 34 



118 



50 



52 



IEDQXA disk data set preformat utility 

IEDQXB disk data set dump utility 99 

IEDQXC print formatted dump utility 90 

INBUF macro 56 

INEND macro 56 

information about TCAM, obtaining 3—4 
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